QCustom3DVolume Class

속성 문서

alphaMultiplier : float

이 속성은 렌더링 시 볼륨 텍스처의 모든 텍셀에 적용될 알파 값에 곱해질 계수를 저장합니다.

이 속성은 볼륨에 균일한 투명도를 적용하는 데 사용할 수 있습니다. ` preserveOpacity `가 ` true`인 경우, 처음부터 어느 정도 투명도를 가진 텍셀에만 영향을 미치며, 완전히 불투명한 텍셀에는 영향을 미치지 않습니다. 이 값은 음수일 수 없습니다. 기본값은 ` 1.0f`입니다.

액세스 함수:

알림 신호:

preserveOpacity 및 textureData도 참조하십시오 .

colorTable : QList<QRgb>

이 속성은 인덱스 기반 텍스처 형식의 색상을 포함하는 배열을 저장합니다.

텍스처 형식이 인덱스 형식이 아닌 경우, 이 배열은 사용되지 않으며 비어 있을 수 있습니다.

기본값은 0 입니다.

액세스 함수:

알림 신호:

textureData, setTextureFormat() 및 QImage::colorTable()도 참조하십시오 .

drawSliceFrames : bool

이 속성은 볼륨 주위에 슬라이스 프레임이 그려지는지 여부를 결정합니다.

이 속성의 값이 ' true'인 경우, 슬라이스 인덱스 속성으로 지정된 슬라이스의 프레임이 볼륨 주위에 그려집니다. ' false'인 경우, 슬라이스 프레임은 그려지지 않습니다.

슬라이스 프레임 그리기는 슬라이스 그리기와 독립적이므로, 전체 볼륨을 표시하면서도 그 주위에 슬라이스 프레임을 그릴 수 있습니다. 이는 renderSlice()를 사용하여 그래프 외부에 슬라이스를 표시할 때 유용합니다.

기본값은 false 입니다.

액세스 함수:

알림 신호:

sliceIndexX, sliceIndexY, sliceIndexZ, drawSlices 및 renderSlice()도 참조하십시오 .

drawSlices : bool

이 속성은 전체 볼륨 대신 지정된 슬라이스가 그려질지 여부를 결정합니다.

이 속성의 값이 ` true`인 경우, 전체 볼륨 대신 슬라이스 인덱스 속성으로 지정된 슬라이스가 그려집니다. ` false`인 경우, 항상 전체 볼륨이 그려집니다. 기본값은 ` false`입니다.

액세스 함수:

알림 신호:

관련 항목: sliceIndexX, sliceIndexY, sliceIndexZ.

preserveOpacity : bool

이 속성은 알파 배율이 모든 텍셀에 적용되는지 여부를 나타냅니다.

이 속성 값이 ` true`인 경우, ` alphaMultiplier `는 이미 어느 정도 투명도를 가진 텍셀에만 적용됩니다. ` false`인 경우, 승수는 모든 텍셀의 알파 값에 적용됩니다. 기본값은 ` true`입니다.

액세스 함수:

알림 신호:

alphaMultiplier도 참조하십시오 .

sliceFrameColor : QColor

이 속성은 슬라이스 프레임의 색상을 지정합니다.

투명한 슬라이스 프레임 색상은 지원되지 않습니다.

기본값은 검은색입니다.

액세스 함수:

알림 신호:

drawSliceFrames도 참조하십시오 .

sliceFrameGaps : QVector3D

이 속성은 볼륨 자체와 프레임 사이에 남는 에어 갭의 크기를 각 차원에서 지정합니다.

간격은 차원에 따라 다를 수 있습니다. 값은 해당 차원의 볼륨 두께에 대한 비율로 표시됩니다. 값은 음수일 수 없습니다.

기본값은 QVector3D(0.01, 0.01, 0.01) 입니다.

액세스 함수:

알림 신호:

drawSliceFrames도 참조하십시오 .

sliceFrameThicknesses : QVector3D

이 속성은 각 차원에 대한 슬라이스 프레임의 두께를 저장합니다.

값은 동일한 차원의 부피 두께에 대한 비율로 표시됩니다. 값은 음수일 수 없습니다.

기본값은 QVector3D(0.01, 0.01, 0.01) 입니다.

액세스 함수:

알림 신호:

drawSliceFrames도 참조하십시오 .

sliceFrameWidths : QVector3D

이 속성은 슬라이스 프레임의 너비를 지정합니다.

폭은 차원에 따라 다를 수 있으므로, 예를 들어 특정 차원의 값을 0으로 설정하여 볼륨의 특정 면에 대한 프레임 그리기를 생략할 수 있습니다. 값은 동일한 차원의 볼륨 두께에 대한 비율로 표시됩니다. 값은 음수일 수 없습니다.

기본값은 QVector3D(0.01, 0.01, 0.01) 입니다.

액세스 함수:

알림 신호:

drawSliceFrames도 참조하십시오 .

sliceIndexX : int

이 속성은 텍스처 데이터 내의 x-차원 인덱스를 저장하며, 표시할 수직 슬라이스를 지정합니다.

어떤 차원을 음수로 설정하면 해당 차원에 대한 슬라이스나 슬라이스 프레임이 그려지지 않습니다. 모든 차원이 음수인 경우, 슬라이스나 슬라이스 프레임이 그려지지 않고 볼륨이 정상적으로 렌더링됩니다.

기본값은 -1 입니다.

액세스 함수:

알림 신호:

textureData, drawSlices 및 drawSliceFrames도 참조하십시오 .

sliceIndexY : int

이 속성은 텍스처 데이터 내의 y-차원 인덱스를 저장하며, 표시할 수평 단면을 지정합니다.

어떤 차원을 음수로 설정하면 해당 차원에 대한 슬라이스나 슬라이스 프레임이 그려지지 않습니다. 모든 차원이 음수인 경우, 슬라이스나 슬라이스 프레임이 그려지지 않고 볼륨이 정상적으로 렌더링됩니다.

기본값은 -1 입니다.

액세스 함수:

알림 신호:

textureData, drawSlices 및 drawSliceFrames도 참조하십시오 .

sliceIndexZ : int

이 속성은 텍스처 데이터 내의 z-차원 인덱스를 저장하며, 표시할 수직 슬라이스를 지정합니다.

어떤 차원을 음수로 설정하면 해당 차원에 대한 슬라이스나 슬라이스 프레임이 그려지지 않습니다. 모든 차원이 음수인 경우, 슬라이스나 슬라이스 프레임이 그려지지 않고 볼륨이 정상적으로 렌더링됩니다.

기본값은 -1 입니다.

액세스 함수:

알림 신호:

textureData, drawSlices 및 drawSliceFrames도 참조하십시오 .

textureData : QList<uchar>*

이 속성은 textureFormat 에서 지정한 형식으로 텍스처 데이터가 포함된 배열을 저장합니다.

이 배열의 크기는 최소한 (textureDataWidth * textureHeight * textureDepth * texture format color depth in bytes) 이상이어야 합니다.

3D 텍스처는 2D 하위 텍스처의 스택으로 정의됩니다. 각 하위 텍스처는 동일한 크기(textureDataWidth * textureHeight)여야 하며, 스택의 깊이는 textureDepth 속성에 의해 정의됩니다. 각 2D 텍스처의 데이터는 동일한 형식의 QImage 데이터와 동일하므로, QImage::bits()를 사용하여 각 하위 텍스처에 대한 데이터를 제공할 수 있습니다.

새 배열의 소유권은 QCustom3DVolume 인스턴스로 이전됩니다. 다른 배열이 설정되면 이전 배열은 삭제됩니다. 동일한 배열이 다시 설정되면 배열 내용이 변경된 것으로 간주되어 그래프 렌더링이 트리거됩니다.

기본값은 0 입니다.

액세스 함수:

알림 신호:

관련 항목: colorTable, setTextureFormat(), setSubTextureData(), textureDataWidth().

textureDepth : int

이 속성은 볼륨 콘텐츠를 정의하는 3D 텍스처의 깊이를 픽셀 단위로 저장합니다.

기본값은 0 입니다.

액세스 함수:

알림 신호:

textureData, textureWidth, textureHeight 및 setTextureFormat()도 참조하십시오 .

textureHeight : int

이 속성은 볼륨 콘텐츠를 정의하는 3D 텍스처의 높이를 픽셀 단위로 저장합니다.

기본값은 0 입니다.

액세스 함수:

알림 신호:

textureData, textureWidth, textureDepth 및 setTextureFormat()도 참조하십시오 .

textureWidth : int

이 속성은 볼륨 콘텐츠를 정의하는 3D 텍스처의 너비를 픽셀 단위로 저장합니다.

기본값은 0 입니다.

액세스 함수:

알림 신호:

textureData, textureHeight, textureDepth, setTextureFormat() 및 textureDataWidth()도 참조하십시오 .

useHighDefShader : bool

이 속성은 볼륨을 렌더링할 때 고해상도 셰이더를 사용할지 저해상도 셰이더를 사용할지를 결정합니다.

이 속성의 값이 ` true`인 경우 고해상도 셰이더가 사용됩니다. ` false`인 경우 저해상도 셰이더가 사용됩니다.

고해상도 셰이더는 볼륨이 렌더링될 때 볼륨 텍스처의 모든 가시 텍셀이 샘플링되도록 보장합니다. 저해상도 셰이더는 볼륨 콘텐츠의 대략적인 근사치만 렌더링하지만, 프레임 속도는 훨씬 더 높습니다. 저해상도 셰이더는 볼륨 텍스처의 모든 텍셀이 샘플링된다는 것을 보장하지 않으므로, 볼륨에 뚜렷한 얇은 특징이 포함되어 있는 경우 깜빡임이 발생할 수 있습니다.

기본값은 ‘ true ’입니다.

액세스 함수:

알림 신호:

renderSlice()도 참조하십시오 .