RandomInstancing QML Type

무작위 인스턴싱 테이블을 생성합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• color : InstanceRange
• colorModel : enumeration
• customData : InstanceRange
• gridSpacing : vector3d (since 6.9)
• instanceCount : int
• position : InstanceRange
• randomSeed : int
• rotation : InstanceRange
• scale : InstanceRange

상세 설명

RandomInstancing 유형은 정의된 범위 내에서 대량의 무작위 인스턴스를 생성하는 간편한 방법을 제공합니다. 인스턴스의 수는 instanceCount 속성으로 정의됩니다. 범위는 position, scale, rotation, color 및 customData 속성으로 정의됩니다.

InstanceList도 참조하십시오 .

속성 문서

color : InstanceRange

color 속성은 생성된 인스턴스의 색상 변동 범위를 정의합니다. 유형은 color입니다. 기본값은 비어 있으며, 이 경우 색상은 흰색이 됩니다.

예를 들어, colorModel 속성을 설정하면 채도가 높은 색상만 선택할 수 있습니다.

position, rotation, scale 및 customData항목도 참조하십시오 .

colorModel : enumeration

이 속성은 색상 범위가 어떻게 해석되는지를 제어합니다.

인스턴스 색상은 'from' 및 'to' 색상으로 지정된 범위 내에서 컴포넌트별로 생성됩니다. 색상 모델은 이러한 컴포넌트가 어떻게 정의되는지를 결정합니다.

예를 들어, 다음 색상 범위는

color: InstanceRange {
    from: Qt.hsva(0, 0.1, 0.8, 1)
    to: Qt.hsva(1, 0.3, 1, 1)
}

는 HSV 색상 모델을 사용할 때 모든 파스텔 색상 범위를 생성하지만, RGB 색상 모델을 사용할 때는 분홍색 계열의 색상만 생성합니다.

기본값은 RandomInstancing.RGB

RandomInstancing::color도 참조하십시오 .

customData : InstanceRange

customData 속성은 생성된 인스턴스에 대한 사용자 정의 데이터 변동 범위를 정의합니다. 유형은 ` vector4d`입니다. 기본값은 비어 있으며, 이 경우 생성된 데이터는 ` [0, 0, 0, 0]`가 됩니다.

position, color, rotation 및 scale도 참조하십시오 .

gridSpacing : vector3d [since 6.9]

gridSpacing 속성은 인스턴스 간의 최소 간격을 정의하여 인스턴스들이 겹치지 않도록 합니다. 각 위치는 gridSpacing 에 지정된 값만큼의 간격을 두고 분리됩니다.

지정된 gridSpacing 값으로 요청된 인스턴스 수를 모두 수용할 수 없는 경우, instanceCount 속성은 겹치지 않고 배치할 수 있는 인스턴스 수만큼으로 줄어듭니다.

기본값은 [0, 0, 0] 이며, 이 경우 인스턴스 중첩에 대한 제한이 없습니다.

이 속성은 Qt 6.9에서 도입되었습니다.

position도 참조하십시오 .

instanceCount : int

instanceCount 속성은 생성할 인스턴스의 수를 지정합니다. 이 값을 변경하면 테이블 전체가 다시 생성됩니다.

randomSeed도 참조하십시오 .

position : InstanceRange

position 속성은 생성된 인스턴스의 기하학적 경계를 정의합니다. 기본값은 비어 있으며, 이 경우 생성된 위치는 ` [0, 0, 0]`가 됩니다.

color, rotation, scale 및 customData도 참조하십시오 .

randomSeed : int

이 속성은 난수 생성기의 시드를 정의합니다. 이 값을 -1 이외의 값으로 설정하면 인스턴스 테이블이 생성될 때마다 동일한 내용을 갖도록 보장됩니다. 속성을 추가하거나 변경하면 완전히 다른 테이블이 생성될 수 있으므로 주의하십시오.

기본값은 -1이며, 이 경우 테이블은 생성될 때마다 새로운 난수 값을 얻게 됩니다.

rotation : InstanceRange

rotation 속성은 생성된 인스턴스의 회전 범위를 정의합니다. 이 속성의 유형은 vector3d 이며, 이는 오일러 회전 벡터 [xRotation, yRotation, zRotation] 에 해당합니다. 기본값은 비어 있어 회전이 적용되지 않습니다.

position, color, scale 및 customData도 참조하십시오 .

scale : InstanceRange

scale 속성은 생성된 인스턴스의 크기 조정 범위를 정의합니다. 이 속성의 유형은 ` vector3d`입니다. 균일한 크기 조정을 하려면 ` InstanceRange.proportional `을 ` true `로 설정하십시오. 기본값은 비어 있으며, 이 경우 크기 조정이 적용되지 않습니다.

position, color, rotation 및 customData도 참조하십시오 .