Files
Mitchell Wilson bfe9113685 Copying //UE4/Dev-Documentation to //UE4/Samples-Main (Source: //UE4/Dev-Documentation @ 4321946)
#lockdown Nick.Penwarden
#rb none

============================
  MAJOR FEATURES & CHANGES
============================

Change 3683933 by Jeff.Wilson

	Updated metadata

Change 4094604 by Richard.Hinckley

	Fixing a bug in Match3 with incorrect attempts at unbinding a delegate. Not as much of a code problem as a bad learning example.
	#jira UE-59621

Change 4099126 by Sungjin.Hong

	#loc UE4DocKOR

Change 4105127 by Sungjin.Hong

	removed wrong [include]

Change 4105128 by Sungjin.Hong

	#loc UE4DocKor

Change 4169203 by Sungjin.Hong

	#loc UE4DocKOR

Change 4201118 by Mitchell.Wilson

	Initial check-in of 4.20 Release Notes - Major features only.

Change 4201313 by Jeff.Wilson

	misc fixes

Change 4201319 by Mitchell.Wilson

	Adding 4.20 minor release notes.

Change 4201528 by Jeff.Wilson

	misc fixes

Change 4216361 by Sungjin.Hong

	#loc UE4DocKOR moved or deleted

Change 4216416 by Sungjin.Hong

	#loc UE4DocKOR

Change 4216563 by Sungjin.Hong

	#loc UE4DocKOR

Change 4217772 by Mitchell.Wilson

	Adding some missing minor release notes in the Slate and UMG sections.

Change 4218292 by Mitchell.Wilson

	Commenting out Shotgun documentation link and adding a "coming soon" blurb

Change 4219358 by Tianmin.Xie

	#loc UE4DocCHN moved or deleted

Change 4219564 by Sungjin.Hong

	#loc UE4DocKOR

Change 4220008 by Jeff.Wilson

	Reordered top features; updated language for Niagara

Change 4220814 by Mitchell.Wilson

	Updating Niagara landing page and adding new image.

Change 4220945 by Mitchell.Wilson

	Updating page with note pointing to digital humans page and added related page link for digital humans

Change 4221079 by Mitchell.Wilson

	Submitting page and images for Working With Tracks In Sequencer.

Change 4221223 by Mitchell.Wilson

	Checking in updates to Sequence Recorder page and new images.

Change 4222174 by Yang.Zhang

	#loc UE4DocCHN check in 420 Release Note againest INT verison 4218292  (need update againest for latest release note)

Change 4222188 by Sungjin.Hong

	#loc UE4DocKOR moved or deleted

Change 4222189 by Yang.Zhang

	#loc UE4DocCHN 420 Release Note Update against INT 4220008

Change 4222217 by Tianmin.Xie

	#loc UE4DocCHN moved or deleted

Change 4222310 by Yang.Zhang

	#loc UE4DocCHN 420 Release Note Typo Fixing against INT 4220008

Change 4222335 by Yang.Zhang

	#loc UE4DocCHN TwinblastBust Update against INT 4220945

Change 4222348 by Yang.Zhang

	#loc UE4DocCHN SequenceRecorder Update against INT 3866572

Change 4222355 by Yang.Zhang

	#loc UE4DocCHN SequenceRecorder Update against INT 3244012

Change 4222371 by Yang.Zhang

	#loc UE4DocCHN

Change 4222713 by Sungjin.Hong

	#loc UE4DocKOR

Change 4223218 by Mitchell.Wilson

	Adding Controlling Anim Instances with Sequencer page and images

Change 4223330 by Mitchell.Wilson

	Minor update to formatting.

Change 4223439 by Mitchell.Wilson

	Submitting new TimeRefactorNotes page and images

Change 4224395 by Sungjin.Hong

	#loc UE4DocKOR moved or deleted

Change 4224481 by Yang.Zhang

	#loc UE4DocCHN 419 Release Note Update against INT 3941748

Change 4224497 by Yang.Zhang

	#loc UE4DocCHN moved or deleted

Change 4228591 by Yang.Zhang

	#loc UE4DocCHN Localization Edit Against 4221079

Change 4228596 by Yang.Zhang

	#loc UE4DocCHN

Change 4228598 by Yang.Zhang

	#loc UE4DocCHN Localization Bug Fixing

Change 4228600 by Yang.Zhang

	#loc UE4DocCHN Localization Edit

Change 4233224 by Yang.Zhang

	#loc UE4DocCHN Localization Bug Fixing

Change 4233437 by Sungjin.Hong

	#loc UE4DocKOR

Change 4233440 by Sungjin.Hong

	#loc UE4DocKOR

Change 4240164 by Sungjin.Hong

	#loc UE4DocKOR

Change 4242799 by Yang.Zhang

	#loc UE4DocCHN Localization Editor

Change 4243822 by Sam.Deiter

	Manually moveing these files over from the 4.20 release branch.

Change 4257108 by Ben.Zeigler

	Switch ActionRPG to use IWYU headers

Change 4257489 by Sungjin.Hong

	#loc UE4DocKor

Change 4258770 by Mitchell.Wilson

	Updating filters page and images with 4.20 changes

Change 4258956 by Mitchell.Wilson

	Updating Color Picker doc and images for 4.20

Change 4261325 by Sungjin.Hong

	#loc UE4DocKOR

Change 4261534 by Mitchell.Wilson

	Updating mobilepreviewer doc for 4.20 changes.

Change 4263566 by Robert.Gervais

	Replacing images to address doc-md tool erros. #UE4Doc #fyi Jeff.Wilson, Mitchell.Wilson

Change 4264102 by Yang.Zhang

	#loc UE4DocCHN Localization Edit

Change 4264104 by Yang.Zhang

	#loc UE4DocCHN Localization Edit

Change 4264120 by Yang.Zhang

	#loc UE4DocCHN Localization Bug Fixing

Change 4264799 by paulo.souza

	Fix ActionRPG main menu logo "action" and "sample" labels were misplaced #fyi sam.deiter #rb none

Change 4267571 by Sungjin.Hong

	#loc UE4DocKOR

Change 4268090 by Sungjin.Hong

	#loc UE4DocKOR

Change 4272340 by Mitchell.Wilson

	Adding all MR pages for 4.20

Change 4273092 by Mitchell.Wilson

	Updating Mesh Details page for 4.20

Change 4276731 by Mitchell.Wilson

	Checking in nDisplay doc.

Change 4276770 by Jeff.Wilson

	Updated formatting

Change 4276798 by Jeff.Wilson

	Minor formatting update

Change 4276998 by Mitchell.Wilson

	Checking in nDisplay changes for 4.20

Change 4278693 by Sungjin.Hong

	#loc UE4DocKOR moved or deleted

Change 4279407 by Mitchell.Wilson

	Adding ScriptingAndAutomation folder and content

Change 4279418 by Mitchell.Wilson

	Updating crumbs

Change 4279440 by Mitchell.Wilson

	Adding INT to file.

Change 4280273 by paulo.souza

	ARPG - Player AI can now use Potions and Skills when possible/necessary

Change 4280342 by Mitchell.Wilson

	Adding blueprint/python switchable content.

Change 4282437 by Yang.Zhang

	#loc UE4DocCHN moved or deleted

Change 4282603 by Yang.Zhang

	Outsourcing 20180814

Change 4282681 by Yang.Zhang

	#loc UE4DocCHN English Update

Change 4282721 by Yang.Zhang

	#loc UE4DocCHN Localization Editor 20180807

Change 4282938 by Sungjin.Hong

	#loc UE4DocKOR

Change 4283510 by paulo.souza

	ARPG - Initial support for consumable items (health and mana potions)

Change 4283679 by Mitchell.Wilson

	Submitting updates to some ScriptingAndAutomation pages and adding HowTos sections.

Change 4283941 by Mitchell.Wilson

	Submitting new page and content

Change 4284256 by Mitchell.Wilson

	Minor updates to fix topic lists

Change 4284421 by Mitchell.Wilson

	Checking in python page and content

Change 4284468 by Mitchell.Wilson

	Minor updates.

Change 4284888 by Mitchell.Wilson

	Adding new page and content

Change 4285161 by Mitchell.Wilson

	Adding new page and content

Change 4285387 by Jeff.Wilson

	minor styling updates

Change 4287470 by Mitchell.Wilson

	Adding new page and content

Change 4291477 by Sungjin.Hong

	#loc UE4DocKOR moved or deleted

Change 4291478 by Sungjin.Hong

	#loc UE4DocKOR

Change 4291995 by Sungjin.Hong

	#loc UE4DocKOR

Change 4292193 by Mitchell.Wilson

	Updating page and content

Change 4292827 by Mitchell.Wilson

	adding digital humans page and content

Change 4293098 by Mitchell.Wilson

	Updating CascadeToNiagara and adding some content

Change 4295473 by Sungjin.Hong

	#loc UE4DocKOR moved or deleted

Change 4295612 by Sungjin.Hong

	#loc UE4DocKOR

Change 4295997 by Sungjin.Hong

	#loc UE4DocKOR

Change 4296011 by Sungjin.Hong

	#loc UE4DocKOR

Change 4296954 by Mitchell.Wilson

	Fixing LODs on one mesh to resolve flicker. Rebuilt lighting
	#jira UE-58995

Change 4297342 by Mitchell.Wilson

	Updating copyright text in Match3 credits
	#jira UE-61819

Change 4298354 by Mitchell.Wilson

	Updating Photorealistic Character Bust eye material to be consistent with Content Examples setup.
	#jira UE-59761

Change 4299738 by Yang.Zhang

	#loc UE4DocCHN moved or deleted

Change 4299936 by Sungjin.Hong

	#loc UE4DocKOR

Change 4300185 by Mitchell.Wilson

	Updating page to 4.20

Change 4300194 by Mitchell.Wilson

	Updating page and one image

Change 4300247 by Jeff.Wilson

	Fixed publishing errors

Change 4300533 by Jeff.Wilson

	Updates for publishing

Change 4300884 by Mitchell.Wilson

	Updating page and content

Change 4301216 by Mitchell.Wilson

	Updating page and content

Change 4301268 by Mitchell.Wilson

	Updating page and content

Change 4301301 by Mitchell.Wilson

	Updating page and content

Change 4302195 by Mitchell.Wilson

	Updating page and adding content

Change 4303253 by Yang.Zhang

	#loc UE4DocCHN Localization Edit 20180414

Change 4303325 by Sungjin.Hong

	#loc UE4DocKOR

Change 4303706 by Sungjin.Hong

	#loc UE4DocKOR

Change 4305335 by Mitchell.Wilson

	Fixing errors on pages in prep for publish

Change 4305416 by Mitchell.Wilson

	Removing Graph Panel section to resolve errors since it was already commented out.

Change 4305436 by Mitchell.Wilson

	Removing graph panel from commented section to resolve errors

Change 4305504 by Mitchell.Wilson

	Fixing up an image to resolve errors

Change 4305576 by Mitchell.Wilson

	Updated graph panel link to new location.

Change 4305778 by Mitchell.Wilson

	Fixing broken comment

Change 4306900 by Sungjin.Hong

	#loc UE4DocKOR

Change 4307010 by Mitchell.Wilson

	Updating this page to resolve issues on another

Change 4307038 by Mitchell.Wilson

	Removing missing image references, but leaving the descriptions if they ever need to be added back. images are commented out.

Change 4307067 by Mitchell.Wilson

	Removing outdated note to resolve errors.

Change 4307073 by Mitchell.Wilson

	Removing old link that was commented out to resolve errors

Change 4307105 by Mitchell.Wilson

	Removing old image that is no longer used in the new CMS

Change 4307127 by Mitchell.Wilson

	Fixing up comment and removing section that is not used to resolve errors

Change 4307254 by Mitchell.Wilson

	Removing some old URL references that were already commented out to resolve errors.

Change 4307277 by Mitchell.Wilson

	Fixing up incorrect link to resolve errors

Change 4307289 by Mitchell.Wilson

	Fixing up incorrect URL to resovle errors

Change 4307291 by Mitchell.Wilson

	Updating URL for a page that was moved.

Change 4307670 by Mitchell.Wilson

	Fixing up multiple issues to resolve errors

Change 4308120 by Mitchell.Wilson

	Fixing up comments to resolve errors

Change 4308165 by Mitchell.Wilson

	Removing old commented section to resolve errors

Change 4308189 by Mitchell.Wilson

	Removing commented out related pages section to resolve errors.

Change 4308942 by Mitchell.Wilson

	Removing topic image link to resolve error

Change 4309000 by Mitchell.Wilson

	Fixing up some typos in images to resolve errors

Change 4309042 by Mitchell.Wilson

	Fixing up old URL to resolve errors

Change 4309060 by Mitchell.Wilson

	Updating URLs to resolve crashing

Change 4309073 by Mitchell.Wilson

	Updating URLs to resolve crash

Change 4309085 by Mitchell.Wilson

	Removing old URL located in a comment to resolve error

Change 4309106 by Mitchell.Wilson

	Updating related pages to resolve errors

Change 4309130 by Mitchell.Wilson

	Fixing topic image to resolve error

Change 4309167 by Mitchell.Wilson

	Remove include to resolve errors

Change 4309172 by Mitchell.Wilson

	Removing include to resolve errors

Change 4309183 by Mitchell.Wilson

	Fixing up table to resolve error

Change 4309189 by Mitchell.Wilson

	Removing old image to resolve errors

Change 4310574 by Sungjin.Hong

	#loc UE4DocKOR

Change 4310769 by Sungjin.Hong

	#loc UE4DocKOR

Change 4311446 by Mitchell.Wilson

	Adding missing image file

Change 4312754 by Jeff.Wilson

	Added new DoF pages and updates

Change 4313881 by Sungjin.Hong

	#loc UE4DocKOR moved or deleted

Change 4313999 by Yang.Zhang

	#loc UE4DocCHN moved or deleted

Change 4314037 by Sungjin.Hong

	corrected some links, tags, and spaces

Change 4314071 by Sungjin.Hong

	#loc UE4DocKOR

Change 4314302 by Sungjin.Hong

	#loc UE4DocKOR

Change 4314504 by Mitchell.Wilson

	Adding missing tutorial image and updating tutorial.
	#jira UEDOC-7229

Change 4317861 by Sungjin.Hong

	#loc ?????? -> ??????

Change 4320148 by Mitchell.Wilson

	Removing comments on topics

Change 4320159 by Jeff.Wilson

	Fixed async gifs

Change 4320499 by Mitchell.Wilson

	Checking in topic images

Change 4321330 by Sungjin.Hong

	#loc UE4DocKOR

Change 4321337 by Yang.Zhang

	Outsourcing 20180821

Change 4321362 by Yang.Zhang

	#loc UE4DocCHN Localization Bug Fixing 2080828

[CL 4322126 by Mitchell Wilson in Main branch]
2018-08-28 10:33:31 -04:00

157 lines
8.0 KiB
Plaintext

INTSourceChangelist:3692802
Availability: Public
Title: 환경설정 파일
Crumbs: %ROOT%, Engine, Programming, Programming/Basics
Description:게임플레이나 엔진 작동방식 프로퍼티 세팅이 들어있는 텍스트 파일입니다.
Version: 4.9
[TOC (start:2 end:3)]
환경설정 파일은 프로젝트 로드시 초기화시킬 프로퍼티에 대한 값을 설정하는 데 사용될 수 있습니다. 환경설정은 섹션별로 배치된 키-값 짝으로 이루어집니다.
주어진 키에 하나 이상의 값이 할당될 수 있습니다.
엔진 환경설정 파일은 오브젝트와 변수 기본값에 사용됩니다. 사용자 입력 환경설정 파일은 키 바인딩(지정)에 사용됩니다. 기본적으로 **프로젝트 마법사** 를 통해 빈 프로젝트를 생성하면,
DefaultEngine.ini, DefaultGame.ini 파일이 생성됩니다. 템플릿으로 새로 시작하는 프로젝트의 경우도 필요에 따라 DefaultEditor.ini, DefaultInput.ini 환경설정 파일이 생성될
수 있습니다.
SaveConfig() 함수는 [Config](Programming\UnrealArchitecture\Reference\Classes\Specifiers) 클래스 지정자가 붙은 클래스에서 호출할 수 있습니다. 그러면
[Config](Programming\UnrealArchitecture\Reference\Properties\Specifiers) 프로퍼티 지정자로 마킹된 프로퍼티를 적합한 환경설정 파일에 저장합니다. 일반적으로 SaveConfig() 로 저장된 변수는
**[(패키지).(클래스명)]** 형식을 따르는 섹션 제목에 들어갑니다. 예를 들어 DefaultEngine.ini 의 **[/Script/Engine.Engine]** 섹션은 Engine 패키지에 저장된 Engine 클래스를 가리킵니다.
하드코딩된 섹션 이름에는 예외가 있을 수 있습니다.
기존에 환경설정 파일의 편집을 통해서만 접할 수 있었던 여러가지 세팅은, 언리얼 에디터에서 [](Engine\UI\ProjectSettings) 에디터를 통해 접할 수 있습니다.
## 환경설정 변수 지정하기
환경설정 파일에서 어떤 변수를 읽어들일지 지정하기 위해서는, 해당 변수가 들어있는 클래스의 UCLASS 매크로에 Config 지정자를 먼저 붙여야 합니다.
UCLASS(Config=Game)
class AExampleClass : public AActor
[REGION:note]
(Game 과 같은) 카테고리에는 반드시 Config 지정자가 붙어야 합니다. 그래야 클래스의 변수를 읽어들이고 저장할 환경설정 파일을 결정할 수 있습니다. 가능한 카테고리 모두
FConfigCacheIni 에 정의됩니다. 모든 환경설정 파일 카테고리 목록은, [환경설정 카테고리](#환경설정카테고리) 부분을 참고하시기 바랍니다.
[/REGION]
클래스에 Config 지정자를 붙이는 것은 그저 그 클래스가 환경설정 파일에서 읽어들일 변수가 있고, 어느 파일에서 환경설정을 읽어들일지를 나타낼 뿐입니다.
환경설정 파일에서 읽어들이고 저장할 변수를 지정하기 위해서는, UPROPERTY() 매크로에도 Config 지정자를 붙여줘야 합니다.
UCLASS(Config=Game)
class AExampleClass : public AActor
{
GENERATED_UCLASS_BODY()
UPROPERTY(Config)
float ExampleVariable;
};
프로퍼티의 Config 지정자에는 카테고리가 붙지 않습니다. ExampleVariable 프로퍼티는 이제 [환경설정 파일 구조](#파일계층구조) 내 모든 Game 환경설정 파일에서 읽을 수 있게 되었습니다.
정보 지정을 위한 문법은 다음과 같습니다:
[/Script/ModuleName.ExampleClass]
ExampleVariable=0.0f
### 환경설정 파일과 상속
UCLASS 와 UPROPERTY 의 Config 지정자는 상속됩니다. 즉 자손 클래스는 부모 클래스에서 Config 으로 지정된 모든 변수를 읽어들이고 저장할 수 있으며,
같은 환경설정 파일 카테고리에 있게 된다는 뜻입니다. 변수는 모두 자손 클래스 이름과 같은 섹션 타이틀 아래 있게 됩니다. 예를 들어 위 ExampleClass 를 상속하는
ChildExampleClass 에 대한 환경설정 파일 정보는 다음과 같을 것이며, 같은 Game 환경설정 파일에 저장될 것입니다.
[/Script/ModuleName.ChildExampleClass]
ExampleVariable=0.0f
### 인스턴스별 환경설정
언리얼 엔진 4 에는 오브젝트의 환경설정을 원하는 DefaultInput.ini에 저장할 수 있는 능력이 있습니다. UCLASS 매크로에 PerObjectConfig 지정자가 사용된 경우,
이 클래스에 대한 환경설정 정보가 인스턴스별로 저장되며, 각 인스턴스는 .ini 파일에 [오브젝트명 클래스명] 형식으로 오브젝트 이름을 딴 섹션을 갖습니다.
이 키워드는 자손 클래스에 전파됩니다.
## 환경설정 파일 구조
각 환경설정 카테고리는 별도의 파일 계층구조가 있어, 엔진 전용, 프로젝트 전용, 플랫폼 전용 환경설정을 나타냅니다.
### 환경설정 카테고리
* Compat
* DeviceProfiles
* Editor
* EditorGameAgnostic
* EditorKeyBindings
* EditorUserSettings
* Engine
* Game
* Input
* Lightmass
* Scalability
### 파일 계층구조
환경설정 파일 계층구조는 Base.ini 로 시작해서 읽어들이며, 계층구조의 나중 파일에 있는 값이 앞선 값을 덮어씁니다. Engine 폴더에 있는 모든 파일은
모든 프로젝트에 적용되는 반면, 프로젝트 전용 세팅은 해당 프로젝트 디렉터리에 있을 것입니다. 마지막으로, 모든 프로젝트 전용과 플랫폼 전용 사이의 차이점은 [ProjectDirectory]/Saved/Config/[Platform]/[Category].ini 파일에 저장됩니다.
아래 파일 계층구조 예제는 환경설정 파일의 Engine 카테고리에 대한 것입니다.
1. Engine/Config/Base.ini
[REGION:note]
Base.ini 는 보통 비어있습니다.
[/REGION]
1. Engine/Config/BaseEngine.ini
1. Engine/Config/[Platform]/[Platform]Engine.ini
1. [ProjectDirectory]/Config/DefaultEngine.ini
1. [ProjectDirectory]/Config/[Platform]/[Platform]Engine.ini
1. [ProjectDirectory]/Saved/Config/[Platform]/Engine.ini
[REGION:note]
Saved 디렉터리에 있는 환경설정 파일은 환경설정 파일 스택 내 프로젝트 전용과 플랫폼 전용 사이의 차이점만 저장합니다.
[/REGION]
## 환경설정 파일 작업하기
### 파일 포맷
#### 섹션 및 키-값 짝
전형적인 환경설정 파일은 키-값 짝들로 이루어진 섹션들로 구성되며, 그 배치는 다음과 같습니다:
[섹션]
키=값
#### 특수 문자
* *+* - 해당 프로퍼티가 (기존 환경설정 파일 또는 같은 환경설정 파일의 앞부분에) 존재하지 않는 경우 줄을 추가합니다.
* *-* - 줄을 제거합니다(만 정확히 일치해야 합니다).
* *.* - 새 프로퍼티를 추가합니다.
* *!* - 프로퍼티를 제거합니다만, 정확히 일치할 필요는 없으며, 프로퍼티 이름만 맞으면 됩니다.
[REGION:note]
. 은 중복된 줄이 추가될 수 있다는 점만 빼고 + 와 비슷합니다. (DefaultInput.ini 에서 보듯이) 바인딩에 유용한 것으로, 가장 아래쪽의 바인딩만 효력을 발휘합니다. 예를 들어 다음과 같은 경우:
[/Script/Engine.PlayerInput]
Bindings=(Name="Q",Command="Foo")
.Bindings=(Name="Q",Command="Bar")
.Bindings=(Name="Q",Command="Foo")
정상 작동합니다. *+* 를 사용했다면 마지막 줄의 추가는 실패하여 바인딩이 잘못될 것입니다. 환경설정 파일 합침으로 인해, 위의 사용 패턴이 발생할 수 있습니다.
[/REGION]
#### 코멘트
대부분의 사람들이 세미콜론은 환경설정 파일의 코멘트를 나타낸다는 인상을 받는 듯 하지만, 그렇지 않습니다 (FConfigFile::ProcessInputFileContents 에서 세미콜론이나 다른 스트링을 코멘트 구분자로 실제 처리하는 부분은 없습니다). 이는 의도된 동작입니다. 기술적으로는 어떠한 글자도 다른 키-값 짝을 나타낼 수 있습니다. 전형적으로는, 새 줄 처음에 세미콜론을 찍는 것으로 코멘트처럼 쓰긴 하지만, 실제로는 그렇지 않습니다.
; 이것은 코멘트입니다.
; 이것도요!