NX Open C++ 参考指南 2406 v1.1
载入中...
搜索中...
未找到
Public 类型 | Public 成员函数 | 所有成员列表
NXOpen::ModelingViewHighQualityImage类 参考

建模视图高质量图像类 更多...

#include <ModelingViewHighQualityImage.hxx>

Public 类型

enum  DisplayTechniqueType {
  DisplayTechniqueTypeRgbPlusNoise , DisplayTechniqueTypeFsRgb , DisplayTechniqueTypeFsRgbPlusNoise , DisplayTechniqueTypeMonochrome ,
  DisplayTechniqueTypeGrayScale , DisplayTechniqueTypeNearestRgb , DisplayTechniqueTypeOrderedDither , DisplayTechniqueTypeTcPlusNoise
}
enum  FormatType { FormatTypeRasterImage , FormatTypeQtvrPanorama , FormatTypeQtvrObjectLow , FormatTypeQtvrObjectHigh }
enum  ShadeMethod {
  ShadeMethodFlat , ShadeMethodGouraud , ShadeMethodPhong , ShadeMethodImproved ,
  ShadeMethodPreview , ShadeMethodPhotoRealistic , ShadeMethodRayTraced , ShadeMethodRayTracedFfa ,
  ShadeMethodRadiosity , ShadeMethodHybridRadiosity
}

Public 成员函数

NXOpen::ModelingViewHighQualityImage::DisplayTechniqueType DisplayTechnique ()
void Erase ()
double FacetsQuality ()
NXOpen::ModelingViewHighQualityImage::FormatType Format ()
void Generate ()
void GetImageCounts (int *numberBodiesRendered, int *numberFacesRendered, int *numberPolygonsGenerated, double *polygonGenerationSeconds, double *shadowGenerationSeconds, double *imageGenerationSeconds)
NXOpen::ModelingViewHighQualityImage::ShadeMethod Method ()
void Plot (NXOpen::Preferences::SessionVisualizationHighQualityImage::ResolutionType resolution, int dotsPerInch, NXOpen::Preferences::SessionVisualizationHighQualityImage::PlotQualityType plotQuality, const char *plotFileName)
void Plot (NXOpen::Preferences::SessionVisualizationHighQualityImage::ResolutionType resolution, int dotsPerInch, NXOpen::Preferences::SessionVisualizationHighQualityImage::PlotQualityType plotQuality, const NXString &plotFileName)
void Save (const char *imageFileName, bool compressImage)
void Save (const NXString &imageFileName, bool compressImage)
void SetDisplayTechnique (NXOpen::ModelingViewHighQualityImage::DisplayTechniqueType displayTechnique)
void SetFacetsQuality (double facetsQuality)
void SetFormat (NXOpen::ModelingViewHighQualityImage::FormatType format)
void SetMethod (NXOpen::ModelingViewHighQualityImage::ShadeMethod method)
void SetShadows (bool generateShadows)
void SetUseIbl (bool useIbl)
bool Shadows ()
void ShowImageInformation ()
tag_t Tag () const
bool UseIbl ()

详细描述

建模视图高质量图像类

表示用于生成建模视图高质量图像的属性和方法
要获取此类的实例，请参考 NXOpen::ModelingView

创建于 NX4.0.0.

成员枚举类型说明

◆ DisplayTechniqueType

enum NXOpen::ModelingViewHighQualityImage::DisplayTechniqueType

描述生成高质量图像时要使用的技术

枚举值
DisplayTechniqueTypeRgbPlusNoise 

RGB 算法通过在抖动前向初始 RGB 值添加 随机噪声来增强。

DisplayTechniqueTypeFsRgb 

像素转换过程使用 Floyd-Steinberg 抖动 算法在图片上分布颜色误差。 对于 8 位平面显示设备，这是推荐的模式。

DisplayTechniqueTypeFsRgbPlusNoise 

Floyd-Steinberg 算法通过在抖动前向初始 RGB 值添加 随机噪声来增强。对于某些图像，此方法可避免使用 FS RGB 方法时 可能出现的伪影。

DisplayTechniqueTypeMonochrome 

像素使用 Floyd-Steinberg 算法转换为黑白并抖动。 此模式在 1 位显示设备上很有用。

DisplayTechniqueTypeGrayScale 

每个像素使用 NTSC 颜色转灰度转换 转换为灰度级。

DisplayTechniqueTypeNearestRgb 

转换为颜色查找表中最接近的 RGB 值。

DisplayTechniqueTypeOrderedDither 

颜色抖动矩阵筛选像素颜色。这是颜色分辨率 与屏幕分辨率的权衡。此方法比 Floyd-Steinberg 抖动方法快，但 往往会在输出图像中引入明显的图案。

DisplayTechniqueTypeTcPlusNoise 

向每个像素添加随机噪声，其中噪声是 专门为真彩色显示设备定制的。

◆ FormatType

enum NXOpen::ModelingViewHighQualityImage::FormatType

描述要生成的高质量图像的输出格式

枚举值
FormatTypeRasterImage 

正常的单光栅图像

FormatTypeQtvrPanorama 

Quick Time Virtual Reality 全景电影，是一组 固定视点的图像。查看者可以向各个方向查看。

FormatTypeQtvrObjectLow 

Quick Time Virtual Reality 对象电影，是一组对象在 不同旋转角度下的图像。查看者可以旋转对象以查看其 任何方向。生成的帧数较少。

FormatTypeQtvrObjectHigh 

Quick Time Virtual Reality 对象电影，是一组对象在 不同旋转角度下的图像。查看者可以旋转对象以查看其 任何方向。生成的帧数较多。

◆ ShadeMethod

enum NXOpen::ModelingViewHighQualityImage::ShadeMethod

描述用于生成高质量图像的方法

枚举值
ShadeMethodFlat 

最快的着色方法。每个面 分配统一的颜色。

ShadeMethodGouraud 

提供平滑的插值颜色。 速度略慢于平面着色。

ShadeMethodPhong 

提供比 Gouraud 着色更平滑的高光， 但其他功能支持级别相同。

ShadeMethodImproved 

带有纹理、材质参数、高光和阴影的着色。 质量与照片级真实感相似，但明显更快。

ShadeMethodPreview 

Improved 方法的改进版。预览添加了 对透明度的支持，而不需要 同时对图像进行抗锯齿。

ShadeMethodPhotoRealistic 

Improved 方法的所有功能，加上对 抗锯齿和透明度的支持。使用此模式着色的图像 渲染时间可能是使用 Improved 方法的两到三倍。

ShadeMethodRayTraced 

生成使用光线追踪的照片级真实感图像。 此方法比照片级真实感慢，但它能正确地 抗锯齿或渲染纹理。

ShadeMethodRayTracedFfa 

与光线追踪选项相同，但带有 特征跟随抗锯齿。

ShadeMethodRadiosity 

一种迭代光处理方法，其中场景中的间接照明 由图像渲染前表面反射的直接光推导而来。 当您的建模场景需要物理精确的照明时使用此方法。

ShadeMethodHybridRadiosity 

使用标准渲染技术计算直接照明 并结合辐射度处理间接照明以进行 图像渲染。当还需要精确的 直接照明效果时，使用此方法代替辐射度。

成员函数说明

◆ DisplayTechnique()

NXOpen::ModelingViewHighQualityImage::DisplayTechniqueType NXOpen::ModelingViewHighQualityImage::DisplayTechnique ( )

返回生成高质量图像时使用的显示技术。
创建于 NX4.0.0。

许可证要求：无

◆ Erase()

void NXOpen::ModelingViewHighQualityImage::Erase ( )

删除之前生成的视图高质量图像。 当前指定的视图必须是工作视图。
创建于 NX4.0.0 版本。

许可证要求：无

◆ FacetsQuality()

double NXOpen::ModelingViewHighQualityImage::FacetsQuality ( )

返回高质量图像的面片质量。
创建于 NX4.0.0。

许可证要求：无

◆ Format()

NXOpen::ModelingViewHighQualityImage::FormatType NXOpen::ModelingViewHighQualityImage::Format ( )

返回生成高质量图像时使用的格式。
创建于 NX4.0.0。

许可证要求：无

◆ Generate()

void NXOpen::ModelingViewHighQualityImage::Generate ( )

根据之前为视图定义的着色参数生成视图的高质量图像。 当前给定视图必须是工作视图。
创建于 NX4.0.0。

许可证要求：无

◆ GetImageCounts()

void NXOpen::ModelingViewHighQualityImage::GetImageCounts ( int * numberBodiesRendered,
int * numberFacesRendered,
int * numberPolygonsGenerated,
double * polygonGenerationSeconds,
double * shadowGenerationSeconds,
double * imageGenerationSeconds )

获取关于最后渲染图像的信息。如果会话中尚未渲染过图像，将返回所有零值。
目前该函数未使用输入的 modeling_view，因为信息会返回最后渲染的图像的信息，无论该图像是为哪个视图渲染的。这一点在未来可能会改变。

创建于 NX4.0.0 版本。

许可证要求：无

参数
numberBodiesRendered图像渲染的体的数量
numberFacesRendered图像渲染的面的数量
numberPolygonsGenerated从面为图像创建的多边形数量
polygonGenerationSeconds生成多边形所用的秒数
shadowGenerationSeconds生成阴影所用的秒数
imageGenerationSeconds生成图像所用的秒数

◆ Method()

NXOpen::ModelingViewHighQualityImage::ShadeMethod NXOpen::ModelingViewHighQualityImage::Method ( )

返回生成高质量图像时使用的方法。
创建于 NX4.0.0。

许可证要求：无

◆ Plot() [1/2]

void NXOpen::ModelingViewHighQualityImage::Plot ( NXOpen::Preferences::SessionVisualizationHighQualityImage::ResolutionType resolution,
int dotsPerInch,
NXOpen::Preferences::SessionVisualizationHighQualityImage::PlotQualityType plotQuality,
const char * plotFileName )

打印之前生成的视图高质量图像。 当前指定的视图必须是工作视图。
创建于 NX4.0.0 版本。

许可证要求：无

参数
resolution打印的分辨率
dotsPerInch仅当分辨率为 ...user_defined 时使用
plotQuality打印的质量等级
plotFileName要创建的打印文件的完整路径名

◆ Plot() [2/2]

void NXOpen::ModelingViewHighQualityImage::Plot ( NXOpen::Preferences::SessionVisualizationHighQualityImage::ResolutionType resolution,
int dotsPerInch,
NXOpen::Preferences::SessionVisualizationHighQualityImage::PlotQualityType plotQuality,
const NXString & plotFileName )

打印之前生成的视图高质量图像。 当前指定的视图必须是工作视图。
创建于 NX4.0.0 版本。

许可证要求：无

参数
resolution打印的分辨率
dotsPerInch仅当分辨率为 ...user_defined 时使用
plotQuality打印的质量等级
plotFileName要创建的打印文件的完整路径名

◆ Save() [1/2]

void NXOpen::ModelingViewHighQualityImage::Save ( const char * imageFileName,
bool compressImage )

将视图当前显示的高质量图像保存到文件。 当前指定的视图必须是工作视图。 该函数仅在交互模式下工作，不适用于批处理模式。
批处理模式支持请参考类 NXOpen::Gateway::ImageCaptureBuilder

创建于 NX4.0.0 版本。

许可证要求：无

参数
imageFileName保存图像的文件名。可以包含扩展名，允许的扩展名有 .tif、.jpg、.gif 或 .wrl。如果未提供扩展名或提供了无效的扩展名，将创建 .tif 文件
compressImage图像文件是否需要压缩？

◆ Save() [2/2]

void NXOpen::ModelingViewHighQualityImage::Save ( const NXString & imageFileName,
bool compressImage )

将当前显示的视图高质量图像保存到文件。 当前给定视图必须是工作视图。 此函数仅在交互模式下工作，不在批处理模式下工作。
有关批处理模式支持，请参考类 NXOpen::Gateway::ImageCaptureBuilder 。

创建于 NX4.0.0。

许可证要求：无

参数
imageFileName保存图像的文件名。可包含扩展名， 如 .tif、.jpg、.gif 或 .wrl。 若未提供扩展名或扩展名无效， 将创建 .tif 文件
compressImage图像文件是否应压缩

◆ SetDisplayTechnique()

void NXOpen::ModelingViewHighQualityImage::SetDisplayTechnique ( NXOpen::ModelingViewHighQualityImage::DisplayTechniqueType displayTechnique)

设置生成高质量图像时使用的显示技术。
创建于 NX4.0.0。

许可证要求：无

参数
displayTechnique显示技术

◆ SetFacetsQuality()

void NXOpen::ModelingViewHighQualityImage::SetFacetsQuality ( double facetsQuality)

设置高质量图像的面片质量。
创建于 NX4.0.0。

许可证要求：无

参数
facetsQuality范围在 0.1[平滑] 到 2.0[粗糙] 之间

◆ SetFormat()

void NXOpen::ModelingViewHighQualityImage::SetFormat ( NXOpen::ModelingViewHighQualityImage::FormatType format)

设置生成高质量图像时使用的格式。
创建于 NX4.0.0。

许可证要求：无

参数
format格式

◆ SetMethod()

void NXOpen::ModelingViewHighQualityImage::SetMethod ( NXOpen::ModelingViewHighQualityImage::ShadeMethod method)

设置生成高质量图像时使用的方法。
创建于 NX4.0.0。

许可证要求：无

参数
method方法

◆ SetShadows()

void NXOpen::ModelingViewHighQualityImage::SetShadows ( bool generateShadows)

设置高质量图像是否包含阴影的设置。
创建于 NX4.0.0。

许可证要求：无

参数
generateShadows生成阴影

◆ SetUseIbl()

void NXOpen::ModelingViewHighQualityImage::SetUseIbl ( bool useIbl)

设置高质量图像是否使用图像基于照明（IBL）的设置。
创建于 NX4.0.0。

许可证要求：无

参数
useIbl当为 true 时，使用图像基于照明替代单独的光源用于高质量图像

◆ Shadows()

bool NXOpen::ModelingViewHighQualityImage::Shadows ( )

返回高质量图像是否包含阴影的设置。
创建于 NX4.0.0。

许可证要求：无

◆ ShowImageInformation()

void NXOpen::ModelingViewHighQualityImage::ShowImageInformation ( )

显示关于最后渲染图像的信息。这些信息与高质量图像对话框上“信息”按钮显示的内容一致，并会显示在列表窗口中。
如果会话中尚未渲染过图像，显示的信息将无意义，因此在会话中尚未渲染图像时不应使用该方法。

目前该函数未使用输入的 modeling_view，因为信息会返回最后渲染的图像的信息，无论该图像是为哪个视图渲染的。这一点在未来可能会改变。

仅内部模式可用。

创建于 NX4.0.0 版本。

许可证要求：无

◆ Tag()

tag_t NXOpen::ModelingViewHighQualityImage::Tag ( ) const

返回该对象的标签。

◆ UseIbl()

bool NXOpen::ModelingViewHighQualityImage::UseIbl ( )

返回高质量图像是否使用图像基于照明（IBL）的设置。
创建于 NX4.0.0。

许可证要求：无