Bin & Particle Dictionary

Mọi trang khác trong mục này dạy bạn làm một việc gì đó. Trang này dành cho lúc bạn đang cuộn một bản dump .py, gặp một thuộc tính chưa từng thấy, và chỉ muốn biết nó là gì và nằm ở đâu.

Các mục được nhóm theo class sở hữu chúng, vì trong một bin cùng một tên có thể xuất hiện ở nhiều class, và việc bạn đang ở trong class nào quyết định giá trị đó làm gì.

Cách đọc một file bin

Một bin VFX là một cây. Xương sống của nó trông như sau:

VfxSystemDefinitionData              một hiệu ứng hoàn chỉnh, ví dụ recall hoặc chiêu Q
└── complexEmitterDefinitionData     danh sách emitter mà system sở hữu
    └── VfxEmitterDefinitionData     một emitter: một vệt, một tia sáng, vài tia lửa
        ├── primitive                thứ mà mỗi hạt vẽ ra
        └── các con trỏ *Definition  erosion, palette, distortion, con, ...

VfxSystemDefinitionData là vật chứa. Một thuộc tính không nằm trong system được phát trong lúc dùng kỹ năng sẽ không hiện ra trong lúc dùng kỹ năng đó.

Emitter là nơi bạn tốn nhiều thời gian nhất. Riêng nó mang 135 trường đã đăng ký, và treo hơn chục đối tượng sub-definition tùy chọn qua các con trỏ. Con trỏ rỗng nghĩa là cả tính năng đó bị tắt, đó là lý do xóa hẳn một khối thường là cách đúng để tắt một thứ gì đó.

Các lớp bọc giá trị

Thuộc tính số thường được bọc lại để engine có thể giữ chúng cố định hoặc cho chúng thay đổi:

rate: embed = ValueFloat {
    constantValue: f32 = 20
}

Các lớp bọc là ValueFloat, ValueColor, ValueVector2 và ValueVector3. Mỗi cái giữ một constantValue cộng thêm một con trỏ dynamics tùy chọn. Đây là hai trường riêng biệt, không phải hai cách viết của cùng một trường: hằng số luôn có mặt, còn dynamics là một đối tượng phụ treo lên nó.

Thuộc tính lúc sinh và cặp đôi theo vòng đời

Nhiều thuộc tính đi theo cặp. Cái có birth* được tính một lần, khi hạt sinh ra. Cái đi cùng không có tiền tố tiếp tục tác động suốt vòng đời của hạt, và được nhân với giá trị lúc sinh chứ không thay thế nó.

Nếu một giá trị trông sai mà chỉ có một nửa của cặp được ghi, hãy kiểm tra nửa còn lại trước khi đổi bất cứ thứ gì.

Đơn vị

Góc xoay và tốc độ xoay tính bằng độ và độ trên giây. Vòng đời, chu kỳ và độ trễ tính bằng giây. Tốc độ trôi UV tính bằng UV trên giây, còn xoay UV tính bằng độ. Các kênh màu chạy từ 0 đến 1.

Ngẫu nhiên hóa và hậu tố 0

Vài thuộc tính lúc sinh kết thúc bằng 0, như birthScale0 và birthRotation0. Đó là tàn dư đặt tên, không phải cặp nhỏ nhất và lớn nhất. Không có birthScale1 tương ứng trên class emitter hiện tại. Sự biến thiên theo từng hạt đến từ probabilityTables, như ở trên.

Các byte cờ

Nhiều giá trị boolean không phải là trường riêng. Chúng là các bit đơn lẻ được đóng gói vào các byte cờ dùng chung trên emitter. Công cụ dạng văn bản hiển thị từng cái một dưới dạng flag, nên bạn viết lần lượt, nhưng chúng nằm bốn hoặc tám cái trong một byte. Danh sách đầy đủ ở Cờ của emitter.

Cấp system

VfxSystemDefinitionData, vật chứa ngoài cùng. 33 trường đã đăng ký tính đến bản vá 16.16.

Emitter: danh tính và vòng đời

VfxEmitterDefinitionData. Mọi thứ từ đây đến Cờ của emitter đều thuộc class này trừ khi một dòng nói khác.

importance cắt bớt như thế nào

importance được đối chiếu với thiết lập Chất lượng hiệu ứng của người chơi khi system dựng các emitter của nó. Đây là một hạng mục, không phải một thang đo, và hai trong số các giá trị hành xử khác với điều mà tên gọi gợi ý.

Vậy 0 đến 3 tăng dần độ ưu tiên, và 3 là thiết yếu cho lối chơi nên không bao giờ bị cắt. 4 là bản thay thế chất lượng thấp chỉ hiện ở thiết lập thấp, còn 5 thì ngược lại, chỉ hiện từ Trung bình trở lên. Ghép một emitter 4 với một emitter 5 là cách một hiệu ứng xuất xưởng hai phiên bản của chính nó.

Bốn thứ khác quyết định emitter có tồn tại hay không: disabled, colorblindVisibility, ChanceToNotExist, và bit 0x800 trong flags của system, vốn lược bỏ mọi thứ trừ importance 3 và 4.

rate, lifetime, particleLifetime và particleLinger được minh họa bằng ảnh chụp màn hình trên trang Emitter Library.

Emitter: phát và nhịp thời gian

Emitter: vị trí và hướng

Emitter: thuộc tính lúc sinh

Trạng thái mà hạt nhận được ngay khi sinh ra. Mọi thứ tên birth* đều là điều kiện ban đầu, không phải điều kiện liên tục.

Mỗi cái đều có một người anh em flex* (flexBirthVelocity, flexBirthUVOffset, flexScaleBirthScale và tương tự) ghi đè nó khi có giá trị flex được cung cấp.

Emitter: chuyển động theo vòng đời

Trong khi birth* đặt trạng thái ban đầu, những cái này tiếp tục tác động.

Emitter: màu sắc

Đọc một giá trị RGBA

birthColor: embed = ValueColor {
    constantValue: vec4 = { 1, 0.7059, 0, 1 }
}

Các kênh chạy từ 0 đến 1 chứ không phải 0 đến 255. Để quy đổi, chia cho 255. Kênh xanh lá ở trên là 180, và 180 / 255 cho ra 0.7059.

Giá trị thứ tư là alpha, trong đó 0 là trong suốt hoàn toàn và 1 là đục hoàn toàn.

Để đổi màu trong thực tế, Quartz tính hộ bạn.

Emitter: texture và UV

Emitter: trạng thái render

Các giá trị blendMode

Chúng cố định và giống nhau cho mọi primitive. Mỗi chế độ chọn một hệ số hòa trộn nguồn và đích cùng một phép hòa trộn.

Đọc bảng đó trong thực tế:

• 0 và 4 là các chế độ cộng. Màu đen không đóng góp gì, nên đây là những chế độ an toàn để đổi màu về phía đen.
• 1 là hòa trộn alpha tiêu chuẩn, thứ gần nhất với cái gọi là "bình thường".
• 2 làm tối đi, vì nó nhân với nghịch đảo của màu nguồn.
• 3 là chế độ đục. Đây là chế độ duy nhất ghi độ sâu và cũng là chế độ duy nhất không hòa trộn gì cả.
• 6 và 7 lấy giá trị nhỏ nhất hoặc lớn nhất giữa nguồn và đích thay vì cộng.

Cờ của emitter

Bốn byte trên emitter, mỗi byte mang tối đa tám bit có tên. Công cụ dạng văn bản hiển thị từng cái một dưới dạng flag.

Primitive

primitive là một con trỏ quyết định mỗi hạt vẽ ra cái gì. Để trống sẽ cho quad billboard hướng về camera mặc định.

Các trường mesh

Primitive dạng mesh mang một VfxMeshDefinitionData trong mMesh. Chú ý tiền tố m: chúng không viết giống các trường riêng của emitter.

Primitive dạng mesh cũng mang AlignPitchToCamera và AlignYawToCamera trên VfxPrimitiveMeshBase.

Các loại file mesh

Một cặp .skn và .skl trong thư mục particle nghĩa là một mesh có hoạt ảnh. Xem Meshes as Particles.

Vệt và ruy băng

VfxPrimitiveTrailBase mang một VfxTrailDefinitionData trong mTrail:

VfxRibbonDefinitionData mang birthTilingSize dưới dạng ValueVector2.

Các class sub-definition

Mỗi cái treo trên một con trỏ ở emitter. Rỗng nghĩa là tính năng bị tắt hoàn toàn.

Texture mult

VfxTextureMultDefinitionData. Một texture thứ hai nhân lên trên texture nền, đúng ý tưởng của Multiply trong phần mềm chỉnh ảnh. Trường textureMult của emitter trỏ tới đối tượng này, còn tên file thật là chuỗi textureMult nằm bên trong nó.

Byte cờ của nó mang uvScrollAlphaMult, uvScrollClampMult, TextureMultFilpU, TextureMultFilpV và isRandomStartFrameMult. Hai cái cuối đúng là được viết như vậy trong engine, nên hãy tìm "Filp" chứ đừng tìm "Flip" khi bạn đi lùng chúng.

Palette

VfxPaletteDefinitionData. Tô màu hạt bằng cách lấy mẫu từ một texture gradient thay vì dùng một giá trị phẳng.

Erosion alpha

VfxAlphaErosionDefinitionData. Hòa tan hạt bằng một map. Gần như mọi hiệu ứng cháy rụi hay xóa dần đều được dựng theo cách này.

Map erosion thường ở dạng xám, trong đó màu trắng mòn trước và màu đen mòn sau cùng. Map nhiều kênh mang một hoa văn độc lập trên mỗi kênh màu, và erosionMapChannelMixer chọn giữa chúng.

Distortion

VfxDistortionDefinitionData. Làm méo thứ được vẽ phía sau hạt. Sóng xung kích và gợn nhiệt.

Phản chiếu và fresnel

VfxReflectionDefinitionData. Khối viền sáng và phản chiếu. fresnel nằm ở đây, không phải trên emitter.

Soft particles

VfxSoftParticleDefinitionData. Làm mềm đường cắt gắt ở chỗ hạt cắt qua hình khối.

Còn một byte chế độ thứ năm chọn xem phần mờ nào trong hai phần được áp dụng. Một con trỏ softParticleParams rỗng sẽ tắt hẳn tính năng, và không có trường bật tắt riêng nào cả.

Linger

VfxLingerDefinitionData. Thay đổi hạt trong giai đoạn nán lại thay vì chỉ trì hoãn việc xóa nó.

Mỗi cái có một cờ Use* tương ứng: UseLingerRotation, UseLingerScale, UseKeyedLingerVelocity, UseKeyedLingerAcceleration, UseKeyedLingerDrag và UseSeparateLingerColor. Đặt giá trị mà không bật cờ thì chẳng có tác dụng gì.

Material và driver

VfxMaterialDefinitionData giữ một liên kết Material và một map materialDrivers. Các driver tạo hoạt ảnh cho một tham số material thay vì giữ nó cố định.

Về phần glow và toon shader, xem Static Materials.

Trường lực

VfxFieldCollectionDefinitionData, truy cập qua fieldCollectionDefinition của emitter. Trong khi birthVelocity đẩy một hạt vào chuyển động, một trường lực tiếp tục tác động lên nó.

Hình dạng phát

SpawnShape trỏ tới một IVfxShape.

VfxEmissionMeshData lo phần sinh ra từ một mesh, với meshName, skeletonName, AnimationName, meshScale, maxJointWeights, Submeshes và useSurfaceNormalForBirthPhysics.

Hạt con

VfxChildParticleSetDefinitionData, truy cập qua childParticleSetDefinition của emitter. Đây là cách một vệt bắn ra tia lửa hoặc một vụ nổ văng ra mảnh vỡ.

VfxChildIdentifier giữ effect (một liên kết), effectKey (một hash) và effectName (một chuỗi).

VfxParentInheritanceParams giữ Mode và RelativeOffset. Độ lệch đó là một kênh tương đối so với hạt cha đúng nghĩa, tách biệt với EmitterPosition của chính hạt con.

Một mẫu hay gặp là emitter cha dùng VfxPrimitiveNonRenderable: nó không vẽ gì cả và chỉ tồn tại để đặt vị trí cho các hạt con của nó.

Mô hình component legacy

Các hiệu ứng cũ hơn dùng một mô hình emitter thứ hai dựa trên component, vẫn còn đi kèm trong engine. Bạn sẽ gặp nó ở những tướng ra mắt đã lâu. Nó được ghi lại ở đây để bạn nhận ra nó, chứ không phải để bạn viết đồ mới bằng nó.

Nhiều tên xuất hiện ở cả hai mô hình. blendMode, texture, bindWeight, birthVelocity, particleLifetime và những cái khác tồn tại trên emitter hiện đại và trên một component legacy, ở các offset khác nhau. Khi một giá trị có vẻ không có tác dụng, hãy kiểm tra xem bạn đang thực sự sửa cái nào trong hai cái.

Ba cái tên chỉ tồn tại duy nhất trên mô hình legacy:

VfxEmitterLegacySimple cũng mang birthScale, scale, birthRotation, birthRotationalVelocity, rotation, scaleBias, orientation, fixedOrbitType, hasFixedOrbit và scaleUpFromOrigin. Chú ý birthScale và birthRotation không có hậu tố ở đây, đối lập với birthScale0 và birthRotation0 trên emitter hiện đại.

Con trỏ LegacySimple chính là thứ mà các emitter trong danh sách simpleEmitterDefinitionData của system sử dụng. Nếu một system điền vào danh sách đó thay vì complexEmitterDefinitionData, thì đây là khối mà các emitter của nó đọc.

Những thuộc tính emitter đã mất

Bốn thuộc tính của emitter đã bị loại bỏ và giờ chỉ còn xuất hiện trong các bin cũ hoặc tài liệu cũ.

assetCategory đã bị loại khỏi VfxSystemDefinitionData ở bản vá 14.15.

Những chỗ dễ hiểu sai

Một danh sách ngắn các cách hiểu sai tốn thời gian nhất.

Tên và kiểu trên trang này được đọc từ bố cục class do engine đăng ký cho bản vá 16.16. Nếu thiếu một thuộc tính hoặc một mô tả bị sai, rất đáng để sửa: xem Cách đóng góp.