다음을 통해 공유

전역 매개 변수

각 DXSAS 규격 효과는 최소한 전역 의미 체계를 사용하여 단일 전역 효과 매개 변수를 정의해야 합니다. 전역 매개 변수는 하나 이상의 선택적 주석을 사용할 수도 있습니다. 구문은 다음과 같습니다.

int VariableName : SasGlobal
<
    SasVersion 
    [OptionalAnnotations]
>;

어디:

  • VariableName은 사용자가 지정한 ASCII 텍스트 문자열 변수 이름입니다.
  • SasGlobal은 이 매개 변수를 전역 DXSAS 매개 변수로 식별하는 의미 체계 키워드입니다.
  • SasVersion은 유일하게 필요한 주석입니다.
  • OptionalAnnotations에는 다음이 포함될 수 있습니다.
    • sasEffectAuthor
    • sasEffectAuthoringSoftware
    • sasEffectCategory
    • sasEffectCompany
    • sasEffectDescription
    • sasEffectHelp
    • sasEffectRevision

SasVersion

유일하게 필요한 주석은 SasVersion입니다. 다음과 같이 선언됩니다.

int3 SasVersion = { major, minor, revision };

어디:

  • major는 DXSAS 주 릴리스를 나타냅니다. DXSAS의 주요 릴리스에는 정의된 의미 체계 및 주석 집합에 대한 대대적인 변경 내용이 포함될 수 있습니다. 의미 체계 및 주석을 추가 및 제거할 수 있으며 일반적으로 이전 릴리스와의 이전 버전과의 호환성이 보장되지 않습니다.
  • minor는 SAS 부 릴리스를 나타냅니다. DXSAS의 부 릴리스에는 새 의미 체계 또는 주석이 추가될 수 있습니다. 또한 의미 체계 및 주석은 DXSAS 표준에서 사용되지 않는 것으로 표시될 수 있습니다. 사용되지 않는 의미 체계 및 주석은 호스트 애플리케이션에서 계속 지원되어야 하지만 이러한 의미 체계 또는 주석을 사용할 때 경고 진단을 내보낼 수 있습니다. 부 릴리스는 이전 릴리스와 이전 버전과 호환됩니다.
  • 수정 버전은 DXSAS 수정 버전을 나타냅니다. DXSAS의 수정 버전은 버그를 수정하고 모호성을 제거하고 표준을 구체화하는 수단으로만 존재합니다. 표준의 수정 버전은 이전 릴리스와 호환됩니다.

현재 버전은 1.0.0입니다. 이 주석의 기본값은 없습니다.

SasEffectAuthor

그러면 효과를 만든 사람이 선언됩니다. 다음과 같이 선언됩니다.

string SasEffectAuthor = "value";

여기서 값은 효과 작성자를 식별하는 문자열입니다. 기본값은 빈 문자열입니다.

SasEffectAuthoringSoftware

그러면 효과가 작성된 소프트웨어가 선언됩니다. 다음과 같이 선언됩니다.

string SasEffectAuthoringSoftware = "value";

여기서 값은 효과 제작 소프트웨어를 식별하는 문자열입니다. 기본값은 빈 문자열입니다.

SasEffectCategory

그러면 효과 범주가 선언됩니다. 다음과 같이 선언됩니다.

string SasEffectCategory = "value";

여기서 값은 효과 범주를 식별하는 문자열입니다. 기본값은 빈 문자열입니다. 범주는 슬래시를 구분 기호로 사용하여 경로와 유사한 값을 통해 표현됩니다. 효과는 단일 SasEffectCategory 값 내의 여러 경로에 포함을 표현하는 구문이 없기 때문에 하나의 범주에만 속할 수 있습니다. 이 주석의 값은 호스트 애플리케이션에서 대/소문자를 구분하는 것으로 처리되지 않습니다.

SasEffectCompany

그러면 효과를 만든 회사가 선언됩니다. 다음과 같이 선언됩니다.

string SasEffectCompany = "value";

여기서 값은 효과를 소유한 회사의 이름을 식별하는 문자열입니다. 기본값은 빈 문자열입니다.

SasEffectDescription

효과를 설명합니다. 다음과 같이 선언됩니다.

string SasEffectDescription = "value";

여기서 값은 효과를 설명하는 문자열입니다. 기본값은 빈 문자열입니다.

SasEffectHelp

연결된 효과에 대한 도움말이 요청될 때마다 사용자에게 표시할 수 있는 도움말 문자열입니다. 다음과 같이 선언됩니다.

string SasEffectHelp = "value";

여기서 값은 사용자가 도움을 요청하는 경우 표시할 수 있는 문자열입니다. 기본값은 빈 문자열입니다.

SasEffectRevision

이 주석을 사용하면 도구와 사용자가 연결된 효과 파일의 수정 번호를 기록할 수 있습니다. 예를 들어 사용자는 이 주석 값에 적절한 키워드를 삽입하여 즐겨 찾는 수정 컨트롤 소프트웨어에서 키워드 대체를 호출할 수 있습니다. 다음과 같이 선언됩니다.

string SasEffectRevision = "value";

여기서 값은 효과 수정 버전을 식별하는 문자열입니다. 기본값은 빈 문자열입니다.

예제

다음은 필요한 단일 주석만 사용하는 예제입니다.

int gp : SasGlobal
<
  int3 SasVersion = {1,0,0};
>;

다음은 필요한 주석과 몇 가지 선택적 주석을 사용하는 예제입니다.

int gp : SasGlobal
<
  int3 SasVersion = {1,0,0};
  string SasEffectAuthor = "Mike's Shader";
  string SasEffectAuthoringSoftware = "fxe 2.5.4";
  string SasEffectCategory = "/surface/procedural/wood";
  string SasEffectCompany = "Microsoft Corporation";
  string SasEffectDescription = "Renders an iridescent surface.";
  string SasEffectHelp = "For more information, see https://somelocation/skin.htm";    
  string SasEffectRevision = "$Revision$";  
>;

DirectX 표준 주석 및 의미 체계 참조

 

 

  • Last updated on