Trait, Fragment

1/**2 * 매스 엔티티 트레이트의 기본 클래스입니다.3 * 엔티티 트레이트는 최종 사용에(예: 리플리케이션, 시각화) 의미 있는 논리적 트레이트를 생성하는 프래그먼트 집합입니다.4 * 템플릿 생성 메서드를 사용하면 속성이나 캐시된 값을 기반으로 일부 프래그먼트를 구성할 수 있습니다.5 * 예를 들어, 참조된 자산을 기반으로 프래그먼트를 추가하거나, 메모리 소모가 큰 일부 설정을6 * 캐시하여 프래그먼트에 인덱스만 저장할 수 있습니다.7 * Base class for Mass Entity Traits.8 * An entity trait is a set of fragments that create a logical trait tha makes sense to end use (i.e. replication, visualization).9 * The template building method allows to configure some fragments based on properties or cached values.10 * For example, a fragment can be added based on a referenced asset, or some memory hungry settings can be11 * cached and just and index stored on a fragment.12 */13UCLASS(MinimalAPI, Abstract, BlueprintType, EditInlineNew, CollapseCategories, config = Mass, defaultconfig)14class UMassEntityTraitBase : public UObject15{16	GENERATED_BODY()17 18public:19	/** 20     * 이 타입은 기존 TArray를 감싸서, 사용자가 포함된 데이터와 상호작용할 수 있는 방식을 제한합니다.21     * 기본적으로 사용자가 요소를 추가하는 것만 허용하고, 그 외의 작업은 할 수 없도록 제한합니다.22	 * This is a type wrapping an existing TArray to limit how users can interact with the contained data. 23	 * We essentially limit users to just adding elements, no other operations.24	 */25	struct FAdditionalTraitRequirements26	{27		explicit FAdditionalTraitRequirements(TArray<const UStruct*>& InTargetContainer)28			: TargetContainer(InTargetContainer)29		{30		}31		32		// Copying constructor and assignment deleted to prevent users storing copies of the type, 33		// which wouldn't be safe due to this type hosting a reference to an array that can go out of scope.34		FAdditionalTraitRequirements(const FAdditionalTraitRequirements&) = delete;35		FAdditionalTraitRequirements& operator=(const FAdditionalTraitRequirements&) = delete;36 37		FAdditionalTraitRequirements& Add(const UScriptStruct* RequiredType)38		{39			TargetContainer.Add(RequiredType);40			return *this;41		}42 43	private:44		TArray<const UStruct*>& TargetContainer;45	};46 47 48	/** Appends items into the entity template required for the trait. */49	virtual void BuildTemplate(FMassEntityTemplateBuildContext& BuildContext, const UWorld& World) const PURE_VIRTUAL(UMassEntityTraitBase::BuildTemplate, return; );50	virtual void DestroyTemplate(const UWorld& World) const {}51 52	/**53	 * 모든 트레이트가 처리되고 프래그먼트 요구 사항이 확인된 후 호출됩니다. 이 함수를 재정의하여54     * 추가적인 트레이트 구성 유효성 검사를 수행할 수 있습니다. `false`를 반환하면 트레이트 인스턴스가55     * 유효성 검사 결과에 만족하지 않음을 나타내며, 이 결과는 오류로 처리됩니다.56	 * @param OutTraitRequirements: 이 트레이트가 선언한 요구 사항을 포함하며, ValidateTemplate이 BuildContext의 상태를 기반으로57     *        의존성을 추가할 수 있는 기회를 제공합니다. 이 시점에서 BuildContext에는 모든 관련 트레이트가58     *        추가한 모든 요소가 포함되어 있어야 합니다.59     * @return: 유효성 검사가 성공했는지 여부60	 * Called once all traits have been processed and fragment requirements have been checked. Override this function61	 * to perform additional Trait's configuration validation. Returning `false` will indicate that the trait instance62	 * is not happy with the validation results - this result will be treated as an error.63	 * @param OutTraitRequirements contains requirements declared by this trait and gives ValidateTemplate a chance to add 64	 *		to the dependencies based on the state of BuildContext, which by this point should contain all the elements 65	 *		added by all the relevant traits.66	 * @return whether the validation was successful67	 */68	MASSSPAWNER_API virtual bool ValidateTemplate(const FMassEntityTemplateBuildContext& BuildContext, const UWorld& World, FAdditionalTraitRequirements& OutTraitRequirements) const;69};