빠른 찾기(Quick Find) 위젯은 타이밍 뷰에서 표시된 이벤트를 검색 및 필터링하는 데 사용됩니다. 이 위젯은 타이밍 뷰 컨텍스트 메뉴에서 타이밍 이벤트(Timing event) 를 우클릭하여 열거나 타이밍 뷰에 포커스가 있을 때 Ctrl+F 단축키를 사용하여 열 수 있습니다.
빠른 찾기 위젯의 검색 로직은 그룹(Group) 및 필터(Filter) 를 사용하여 정의됩니다. 그룹 노드는 자손 필터 노드를 포함하고, 자손의 결과에 적용되는 로직을 정의합니다. 필터 노드는 리프 노드이며 각각 필터를 하나씩 포함합니다.
각 필터에는 다음이 포함됩니다.
-
드롭다운 메뉴에서 선택 가능한 필터 타입.
-
마찬가지로 드롭다운 메뉴에서 선택 가능한 필터 연산자.
-
텍스트 박스를 사용하여 입력할 수 있는 필터 값.
필터 로직을 생성하면 타이밍 뷰에서 이벤트를 검색하거나 트랙에 필터를 적용하는 데 사용할 수 있습니다.
필터 그룹 및 그룹 타입
필터 그룹은 그 아래에 그룹화된 필터로부터 값이 반환되는 방식을 결정합니다. 다음과 같은 필터 그룹 타입을 사용할 수 있습니다.
| 필터 그룹 타입 | 설명 |
|---|---|
| 모든(AND)(All Of (AND)) | 그룹 내의 모든 필터와 일치하는 필터 결과만 반환합니다. |
| 아무거나(OR)(Any Of (OR)) | 그룹 내의 필터 중 아무거나 일치하는 필터 결과를 반환합니다. |
다수의 필터 그룹을 추가하여 더욱 복잡한 로직을 만들 수 있습니다.
필터 값
다음 파라미터를 개별 필터의 값으로 사용할 수 있습니다.
| 필터 이름 | 값 타입 | 설명 |
|---|---|---|
| 시작 시간(Start Time) | Float | 타이머의 시작 시간입니다. |
| 끝 시간(End Time) | Float | 타이머의 끝 시간입니다. |
| 기간(Duration) | Float | 타이머가 활성화된 기간입니다. |
| 트랙(Track) | String | 타이머가 속한 트랙의 이름입니다. |
| 타이머 ID(Timer ID) | Int | 타이머의 고유 ID입니다. |
| 타이머 이름(Timer Name) | String | 타이머의 이름입니다. |
| 메타데이터(Metadata) | 설명 참조 | 두 가지 필드를 사용하여 키-값 쌍을 기반으로 검색합니다. 첫 번째 필드는 키이며, 값 타입을 직접 지정할 수 있습니다. 이것은 메타데이터 필터에서 검색할 키입니다. 두 번째 값은 비교 대상 메타데이터 값입니다. |
시작 시간, 끝 시간, 기간, 타이머 ID 연산자
숫자 필터는 표준 부울 연산자를 비교에 사용합니다.
트랙 및 타이머 이름 연산자
스트링 기반 필터는 다음 스트링 연산자를 비교에 사용합니다.
| 연산자 | 설명 |
|---|---|
| IS | 제공된 스트링과 정확히 일치하는 값을 반환합니다. |
| IS NOT | 제공된 스트링과 일치하지 않는 값을 반환합니다. |
| CONTAINS | 제공된 스트링을 하위 스트링으로 포함하는 값을 반환합니다. |
| NOT CONTAINS | 제공된 스트링을 포함하지 않는 값을 반환합니다. |
메타데이터 필터를 사용하는 방법
메타데이터 필터를 추가할 때는 필터링하려는 메타데이터와 관련하여 입력할 수 있는 여러 필드가 제공됩니다. 이러한 필드는 다음과 같습니다.
| 인덱스 | 필드 | 설명 |
|---|---|---|
| 1 | 키(Key) | 메타데이터 필드를 포함합니다. 스트링 값이어야 하며, 정확하게 일치해야 합니다. |
| 2 | 데이터 타입(DataType) | 검색할 메타데이터 필드의 타입입니다. 예시: String 또는 Float. |
| 3 | 연산자(Operator) | 메타데이터 값 및 값(Value) 텍스트 박스(아래 참조)의 값에 적용할 연산자입니다. 사용 가능한 연산자는 선택된 데이터 타입(DataType)에 따라 다릅니다. |
| 4 | 값(Value) | 연산자의 두 번째 멤버로 사용할 값입니다. 입력한 값은 선택된 데이터 타입(DataType)과 호환되어야 합니다. |
예를 들면, 타입이 String이고 값에 스트링 'Pawn'을 포함하며 키가 'AssetPath'인 메타데이터 필터를 생성할 수 있습니다.
아래의 두 번째 예시는 메타데이터 필터와 다른 필터 타입의 조합을 보여줍니다. 타입이 Int이고 값이 6500을 초과하며 키가 'SizeInBytes'인 메타데이터 필드가 있는, 이름이 'FRDGBufferPool_CreateBuffer'인 모든 타이머 이름 이벤트를 검색합니다.
특수 스트링 *를 사용하여 키, 타입, 값과 상관없이 메타데이터가 어태치된 모든 이벤트를 표시할 수 있습니다.
컨트롤
빠른 찾기(Quick Find) 패널 하단에는 다음과 같은 컨트롤이 있습니다.
| 작업 | 설명 |
|---|---|
| 첫 번째 찾기(Find First) | 이벤트의 시작 시간순으로 필터와 일치하는 첫 번째 이벤트를 찾습니다. 일치 항목을 찾으면 해당 이벤트가 선택되어 타이밍 뷰에 표시됩니다. |
| 이전 찾기(Find Previous) | 현재 선택한 이벤트의 시작 시간부터 시작해서 필터와 일치하는 이전 이벤트를 찾습니다. 이벤트가 선택되지 않으면 첫 번째 찾기(Find First) 로 작동합니다. |
| 다음 찾기(Find Next) | 현재 선택한 이벤트의 시작 시간부터 시작해서 필터와 일치하는 다음 이벤트를 찾습니다. 이벤트가 선택되지 않으면 마지막 찾기(Find Last) 로 작동합니다. |
| 마지막 찾기(Find Last) | 이벤트의 시작 시간순으로 필터와 일치하는 마지막 이벤트를 찾습니다. 일치 항목을 찾으면 해당 이벤트가 선택되어 타이밍 뷰에 표시됩니다. |
| 메타데이터(Metadata) | 다수의 메타데이터 필드로 필터링할 필드를 제공합니다. 자세한 내용은 메타데이터 필터를 사용하는 방법을 참조하세요. |
| 필터 적용(Apply Filter) | 트랙에서 필터 로직을 통과하는 모든 타이밍 이벤트를 하이라이트합니다. |
| 필터 지우기(Clear filters) | 필터 로직에 따른 이벤트 하이라이트를 중지합니다. |
필터 로직을 변경했다면 필터 적용(Apply Filter) 을 다시 클릭하여 새 로직에 따라 이벤트를 하이라이트해야 합니다.