Một cảnh Blender đồng hành cùng tài nguyên của nó.

Dự án Pli: một công thức cảnh, với phạm vi rõ ràng

Pli là một lọ hư cấu được tạo ra cho bài tập này: thân màu tím với các cạnh mềm mại, cổ áo màu cam sa tanh, nhãn hình chữ V và đế bằng đất sét. Trình tạo dựng sẵn một ánh sáng studio và một bố cục chừa khoảng trống bên trái. Nó dựng các đối tượng và vật liệu; hình ảnh bên ngoài duy nhất là một họa tiết PNG gốc 512 × 512 pixel, kèm theo chương trình tái tạo nó. Không cần mô hình, HDRI, phông chữ hay tệp khách hàng nào.

Mục tiêu là Blender 4.5.x LTS với Cycles. Thư mục dành cho một ảnh tĩnh, không có mô phỏng hay tiện ích mở rộng. Trình tạo từ chối nhánh Blender khác để lựa chọn này luôn rõ ràng. Chỉ cần Python 3.10 trở lên để kiểm tra tệp; để dựng cảnh, cần Python tích hợp trong Blender.

Pli cung cấp một trình tạo để chạy với Blender 4.5.x LTS. Các tệp và trường hợp lỗi đã được kiểm tra dưới Python 3.14.6; việc tạo cảnh, mở và kết xuất vẫn cần thử nghiệm trong Blender. Không có tệp .blend hay bản kết xuất nào được cung cấp.

Trước khi sao chép, hãy quyết định dự án phải tái hiện điều gì

Hãy bắt đầu bằng việc xác định sản phẩm bàn giao: ảnh tĩnh, hoạt ảnh hay loạt biến thể. Ghi lại phần mềm và phiên bản, engine, camera đang hoạt động, cảnh, kích thước và thiết lập chất lượng. Với hoạt ảnh, thêm tốc độ khung hình và các giới hạn bao gồm cả hai đầu. Một cảnh mở được không có nghĩa là tái hiện đúng các texture, cache hay khung hình như cũ.

Hãy làm việc trên một phiên bản cố định và giữ lại bản gốc. Tách riêng các tài nguyên được dùng khỏi những thử nghiệm bị bỏ; hai texture gần giống tên nhau có thể giải thích sự khác biệt về vật liệu. Kiểm tra cả quyền chuyển giao của mô hình, hình ảnh và thư viện. Gói Pli cung cấp giấy phép MIT cho chính các script, tài liệu, họa tiết và hình học được mô tả; các phần bạn thêm vào có thể có điều kiện khác.

Trong Pli, scene.json đóng vai trò phiếu xuất phát: phiên bản mục tiêu, danh mục mười đối tượng, phụ thuộc đồ họa, engine, ảnh 1 và đích đầu ra. Nó cũng chỉ ra những gì không tồn tại trong dự án này: thư viện liên kết, phông chữ, cache và hoạt ảnh. Một sự vắng mặt được khai báo giúp tránh nhầm một thư mục trống là tài nguyên bị bỏ quên.

Một cấu trúc thư mục nơi mỗi tệp có một vai trò

Giữ một thư mục gốc được quản lý phiên bản, ở đây là blender-v1, và giải nén lưu trữ trước khi làm việc. Cách tách riêng dưới đây giúp tìm lại nguồn của một hình ảnh, dự án có thể chỉnh sửa và kết quả cần bàn giao. Nó không áp đặt một quy ước phổ quát: hãy chọn những tên mà người tiếp nhận thư mục hiểu được mà không cần lịch sử tin nhắn của bạn.

Các nguồn được phân phối nằm trong manifest.sha256.json cùng kích thước và dấu vân tay của chúng. Manifest tự loại trừ chính nó để tránh tham chiếu vòng. Các .blend, PNG và báo cáo trong tương lai là đầu ra: chúng sẽ phải vào danh mục bàn giao của riêng bạn sau khi xác nhận.

Kiểm tra tệp ZIP đã giải nén trước khi chạy Blender

Từ thư mục gốc của thư mục đã giải nén, hãy chạy trình xác thực bằng một Python độc lập. Nó so sánh mười ba tệp với manifeste, kiểm tra công thức, các đường dẫn và tệp PNG, rồi phân tích cú pháp của bốn script. Kết quả mong đợi cho gói nguyên vẹn là ok: true và mã thoát 0. Bước kiểm tra này không import bpy và không tạo ra hình ảnh 3D nào.

Các thử nghiệm của chúng tôi bắt đầu từ tệp ZIP được giải nén ở một vị trí khác. Quá trình kiểm tra chỉ cho phép đọc trong bản sao này và trong thư mục của Python được sử dụng; một nỗ lực truy cập vào công thức gốc sẽ bị từ chối rõ ràng. Do đó, thành công không phụ thuộc vào một texture được tìm thấy một cách âm thầm trong thư mục tạo.

Mã 1 buộc bạn phải đọc danh sách lỗi. Đừng viết lại các dấu vân tay để làm biến mất một cảnh báo. Hãy lấy lại kho lưu trữ nguyên vẹn, hoặc tạo một bản làm việc riêng nếu bạn muốn chỉnh sửa cảnh. Một dấu vân tay giống hệt chứng minh tính toàn vẹn của tệp so với manifeste, chứ không chứng minh chất lượng hình ảnh hay danh tính tác giả của nó.

python validate_pack.py --root . --json

Dựng lại chai và yêu cầu một bản render nhỏ trên CPU

Lệnh sau đây là quy trình cần thực hiện trên một máy có Blender 4.5.x LTS; lệnh này chưa được chạy trong quá trình chuẩn bị này. Hãy chạy nó trong một tiến trình riêng: script bắt đầu từ một cảnh trống. Trên Windows, nếu blender không nằm trong PATH, hãy dùng đường dẫn đầy đủ của tệp thực thi; trong PowerShell, hãy đặt trước đường dẫn đó trong dấu ngoặc kép bằng &.\n\nTrình tạo trước tiên kiểm tra gói, tạo các đối tượng, tải texture từ bản sao, nhúng nó vào và lưu 02_projet/renderparcel_pli_v1.blend. Tệp đã lưu đặt sẵn Cycles CPU, 1 200 × 750 pixel, 64 mẫu và ảnh 1. Tùy chọn --render-preview sau đó yêu cầu một tệp PNG 480 × 300 pixel và 16 mẫu, không khử nhiễu. Những con số này là các thiết lập, không phải số đo hiệu năng.\n\nBáo cáo reconstruction.json được ghi sau khi các thao tác thành công và nêu rõ liệu bản render có thực sự được chạy hay không. Để chỉ dựng tệp .blend, hãy bỏ -- --render-preview. Script từ chối ghi đè các đầu ra đã tồn tại: lần thử thứ hai phải thực hiện trong một lần giải nén mới. Tùy chọn --python-exit-code 1 cho phép nhận ra một ngoại lệ của script qua mã thoát của tiến trình.

blender --background --factory-startup --python-exit-code 1 --python generate_scene.py -- --render-preview

Đường dẫn tương đối: mô tả vị trí mà không quên bản sao

Trong Blender, một đường dẫn bắt đầu bằng // được tính theo vị trí của tệp .blend. Vì dự án Pli sẽ nằm trong 02_projet, texture của nó có thể được chỉ định bằng //../03_ressources/pli-chevron.png. Thư mục tài nguyên đi kèm với nó. Tuy nhiên, trình tạo bắt đầu bằng một đường dẫn tuyệt đối được phân giải trong bản sao, nhúng hình ảnh vào, rồi ghi đường dẫn tương đối trước khi lưu.\n\nĐối với một dự án đã có, trước tiên hãy lưu tệp .blend vào thư mục chuyển. Trong File → External Data, Make Paths Relative sẽ chuyển đổi các tham chiếu; thao tác này không sao chép tài nguyên. Report Missing Files giúp phát hiện các liên kết bị hỏng. Find Missing Files tìm các tệp trong thư mục đã chọn và có thể sửa các tham chiếu thành đường dẫn tuyệt đối: hãy kiểm tra lại chúng trước khi chuyển.\n\nĐừng nhầm lẫn giữa «được tìm thấy trên máy này» và «hiện diện trong thư mục». Một texture vẫn còn truy cập được trong Téléchargements có thể che giấu sự thiếu sót. Sau khi sao chép, hãy mở dự án trong một môi trường mà vị trí cũ đó không còn có thể thỏa mãn liên kết nữa, đồng thời giữ một bản sao lưu độc lập.

Nhúng các tài nguyên đủ điều kiện, kiểm kê những tài nguyên khác

Pack Resources cho phép đưa các tài nguyên đủ điều kiện vào file .blend; việc lưu file khiến thao tác này có hiệu lực trong file được truyền đi. Nó không gom hết mọi phụ thuộc: video là một phản ví dụ đã được ghi nhận. Các thư viện liên kết có một lệnh nhúng riêng. Vậy hãy liệt kê những gì được nhúng và những gì phải giữ bên cạnh dự án.

Với Pli, giữ file PNG bên ngoài giúp việc chỉnh sửa dễ dàng hơn, còn việc nhúng nó phải cho phép tìm lại họa tiết trong file đã lưu. Sau khi sửa texture, bạn cần cập nhật tài nguyên thực sự được dùng rồi lưu đúng phiên bản. Chỉ thay thế một file PNG bên cạnh thôi không chứng minh được rằng file .blend dùng các pixel mới của nó.

Mở lại trong một tiến trình thứ hai và điền một biên bản tiếp nhận thực sự

Sau khi tái tạo thành công, inspect_scene.py mở file .blend trong một tiến trình Blender thứ hai, với việc thực thi các script nội bộ bị tắt. Nó kiểm tra bản kiểm kê, camera, các thiết lập đầu ra, biến đổi AgX, texture đã nhúng và đường dẫn tương đối của nó. Báo cáo của nó mô tả việc mở file và dữ liệu; nó không chứng nhận chất lượng của bản render.

Hãy mở file PNG thu được bằng một trình xem ảnh. Kiểm tra rằng lọ vẫn nằm trọn trong khung, rằng nhãn hiển thị họa tiết kem, tím và cam, rằng chỗ tiếp xúc với đế được nhìn rõ và không có texture màu magenta nào xuất hiện. Những tiêu chí này là ý định tiếp nhận; chúng tôi không công bố ảnh mẫu Blender được tính cho gói pack này.

Sao chép 06_livraison/modele-reception.csv thành 06_livraison/reception-executee.csv, rồi điền vào phiếu mới này. Giữ nguyên mẫu: nó thuộc về manifest. Trình kiểm tra chấp nhận bản sao đã điền mà không thay đổi dấu vân tay của các nguồn, điều mà bài kiểm tra tiếp nhận của chúng tôi đã xác minh. Sau đó hãy kiểm kê phiếu này và các đầu ra đã được phê duyệt trong kho lưu trữ bàn giao của bạn.

blender --background --factory-startup --python-exit-code 1 --python inspect_scene.py

Một phụ thuộc bị thiếu phải dừng việc kiểm tra

Bài tập tiêu cực của gói pack xóa pli-chevron.png khỏi một bản sao thử nghiệm, mà không đụng đến các nguồn. Trình kiểm tra khi đó trả về mã 1 và đồng thời chỉ ra file thiếu trong bản kiểm kê lẫn phụ thuộc bị thiếu của công thức. Trình tạo bắt đầu bằng chính kiểm tra này: nó phải từ chối tiếp tục với bản sao không đầy đủ đó.

Một thử nghiệm khác sửa đổi byte đầu tiên của file PNG; việc kiểm tra phát hiện một dấu vân tay khác và một chữ ký ảnh không hợp lệ. Thử nghiệm thứ ba thay đường dẫn của nó bằng một tham chiếu trỏ ra ngoài thư mục, cũng bị từ chối. Những thử nghiệm này kiểm tra các lỗi chuyển giao cụ thể. Chúng không mô phỏng việc mở Blender hay sự biến mất của một cache trong một hoạt cảnh.

Để làm lại bài tập, bạn chỉ làm việc trên một bản giải nén bổ sung và giữ một bản sao nguyên vẹn. Cách sửa là tìm lại đúng tài nguyên và vị trí mong đợi của nó. Một texture khác mang cùng tên không thỏa mãn kiểm tra tính toàn vẹn.

Thêm một hoạt cảnh sẽ thay đổi phạm vi kiểm tra

Cảnh Pli chỉ có một hình ảnh và không cần bất kỳ bộ nhớ đệm nào. Nếu bạn thêm khói, vải hoặc mô phỏng vào đó, hãy ghi rõ loại bộ nhớ đệm, phiên bản tính toán, vị trí và toàn bộ dải hữu ích. Các cơ chế tính trước phụ thuộc vào hệ vật lý; đừng khái quát hóa hành vi của một bộ nhớ đệm cho tất cả những cái khác.

Hãy cố định kết quả trước khi sao chép. Với một chuỗi, hãy kiểm tra đầu, cuối, các thay đổi bối cảnh hoặc mô phỏng, mà cả sự hiện diện của từng tệp trung gian. Ba hình ảnh trông đúng không chứng minh rằng 96 tệp của một hoạt ảnh từ 1 đến 96 đều có sẵn. Hãy chỉ rõ liệu một bộ nhớ đệm được giao hay phải tính lại, với những tham số và đầu vào nào.

Áp dụng cùng logic đó cho các chuỗi texture, volume, âm thanh và phương tiện dựng phim. Đừng xóa những nguồn duy nhất sau khi tạo ZIP: hãy giữ chúng cho đến khi mở bản sao, kiểm tra các đầu ra và khôi phục chúng.

Màu sắc, bộ nhớ và thời lượng: đo lường dự án thực sự

Họa tiết Pli dùng cho màu cơ bản và được khai báo là sRGB. Một bản đồ mô tả pháp tuyến hoặc dịch chuyển không có cùng vai trò; cách diễn giải của nó phải khớp với dữ liệu. Cũng hãy giữ nguyên phép biến đổi hiển thị và độ phơi sáng khi so sánh các đầu ra. Một khác biệt về màu sắc có thể đến từ chuỗi hiển thị, không liên quan đến năng lực tính toán.

Trọng lượng của ZIP không cho biết nhu cầu bộ nhớ GPU. Hình học được đánh giá, các texture thực sự được tải và các bước render quan trọng hơn số lượng tệp trong một gói nén. Một bản xem trước nhỏ trên CPU không dự đoán được đỉnh bộ nhớ lẫn thời lượng render cuối cùng trên GPU. Hãy đo một đầu ra hoàn chỉnh tiêu biểu ở độ phân giải cuối cùng trước khi chọn cấu hình.

Atelier 3D giúp định hình việc kiểm tra này. Sau đó hãy so sánh các cấu hình GPU theo khả năng tương thích và đỉnh quan sát được, với mức dự phòng phù hợp với dự án. Chọn 3, 7 hoặc 30 ngày trong trình cấu hình để bao quát việc mở, thử nghiệm, trả lại, tính toán và khôi phục; không cửa sổ thời gian nào trong số đó tự nó đảm bảo một thời hạn render. Hướng dẫn xuất kéo dài công việc cho đến các tệp bàn giao.

Những gì đã được kiểm tra, và những gì còn phải thực thi

Bảy kiểm tra dưới đây đã được thực thi trên Windows với Python 3.14.6. Gói chứa mười bốn tệp, kể cả manifest; mười ba tệp được các dấu vân tay của nó bao phủ. Texture đã được tái tạo và so sánh từng byte trong môi trường này. Sự bằng nhau của PNG này không chứng minh sự đồng nhất của render 3D giữa các phiên bản hay phần cứng.

Các kiểm tra xoay quanh các tệp, các phụ thuộc và lỗi truyền. Việc tạo .blend, kiểm tra cảnh và render CPU hoặc GPU chưa được thử nghiệm. README đưa ra quy trình để kiểm tra chúng trong Blender 4.5.x LTS.