QGLAbstractScene Class Reference

 #include <QGLAbstractScene>

This class was introduced in Qt3D 4.8.

    Public Types

    enum FormatListType { AsFilter, AsSuffix }

    Public Functions

      QGLAbstractScene ( QObject * parent = 0 )
    virtual ~QGLAbstractScene ()
    virtual void generatePickNodes ()
    virtual QGLSceneNode * mainNode () const = 0
    int nextPickId ()
    virtual QObject * object ( const QString & name ) const
    virtual QStringList objectNames () const
    virtual QList<QObject *> objects () const = 0
    QList<QGLPickNode *> pickNodes () const
    virtual bool pickable () const
    virtual void setPickable ( bool enable )

    Static Public Members

    QGLAbstractScene * loadScene ( const QUrl & url, const QString & format = QString(), const QString & options = QString() )
    QGLAbstractScene * loadScene ( QIODevice * device, const QUrl & url, const QString & format = QString(), const QString & options = QString() )
    QGLAbstractScene * loadScene ( const QString & fileName, const QString & format = QString(), const QString &options = QString() )
    QStringList supportedFormats ( FormatListType t = AsFilter )

详细说明

QGLAbstractScene 这个类可以表示由0或更多个 QGLSceneNode 的实例组成的3D场景.

场景一般通过3D程序包创建,然后经由 QGLSceneFormatPlugin 存入应用程序. The functions in this class provide access to major scene objects so that they can be applied or drawn whenever the application decides.

QGLAbstractScene presents a very simple model of a 3D scene. Subclasses implement the specific scene graph and object representations in a manner specific to the package's format. Subclasses may also provide functionality to create new objects at runtime, but this is not required.

The scene is defined to consist of a number of important objects of the following types:

  • Camera objects define a viewing position in world-coordinates and a projection that maps 3D world co-ordinates to 2D screen co-ordinates. Camera objects should inherit from QGLCamera.
  • Main objects designate the major elements of the scene besides cameras, lights, and effects. Usually they inherit from QGLSceneNode.
  • Light objects define positions and parameters for lighting the scene. Light objects should inherit fromQGLLightParameters.
  • Effect objects define materials, shaders, and textures for use in rendering the surface of objects. Normally effects are activated automatically when main objects are drawn. But effects can be used independently if the 3D format is acting as a library of effects.
  • Mesh objects define geometry information independently of effects. Normally meshes are drawn automatically with an appropriate effect when main objects are drawn. But meshes can be used independently if the 3D format is acting as a library of meshes. Mesh objects should inherit from QGLSceneNode.

Typically, the full scene represented by an external model format is not interesting to the application. 3D modelling packages regularly insert cameras, lights, effects, and other library objects that are useful to the modelling package, but not the application. The mainNode() is usually the most interesting to applications.

QGLAbstractScene makes it easy to access the major scene elements with object(), objects(), and mainNode().

There are many other kinds of objects in the scene that may not be accessible via QGLAbstractScene because they are not considered "important" enough. For example, a file that contains the data for a skateboard object would contain many objects for the board, wheels, texturing effects, animations, and so on. The application may only be interested in the skateboard as a whole, and not its sub-components. The skateboard would be considered an important main object in this case, which can be easily accessed and incorporated into the application's logic.

Each Subclass needs to provide its own policy for deciding which objects are considered "important".

See also QGLSceneNode and QGLSceneFormatPlugin.

Member Type Documentation

enum QGLAbstractScene::FormatListType

This enum specifies the format of the list returned by the supportedFormats() function.

Constant Value Description
QGLAbstractScene::AsFilter 0 Return a format list that may be used as a filter.
QGLAbstractScene::AsSuffix 1 Return a format list that is simply the filename suffixes.

Member Function Documentation

QGLAbstractScene::QGLAbstractScene ( QObject * parent = 0 )

Constructs a 3D scene and attaches it to parent.

QGLAbstractScene::~QGLAbstractScene () [virtual]

Destroys this 3D scene.

void QGLAbstractScene::generatePickNodes () [virtual]

Generates QGLPickNode instances for important QGLSceneNode instances that are pickable. Objects that are either not important or not pickable can be omitted. The default implementation simply generates pick nodes for every top level object of type QGLSceneNode.

Sub-classes may implement different schemes for picking. When doing so parent the QGLPickNode objects onto the scene, so that they will appear in the list returned by pickNodes()

See also pickNodes() and setPickable().

QGLAbstractScene * QGLAbstractScene::loadScene ( const QUrl & url, const QString & format = QString(), const QString & options = QString() ) [static]

Loads a scene from the internet in the specified format using the registered scene format plugins. If format is an empty string, then the format will be autodetected from the filename extension of the url, which specifies the location of the data online.

The options string is passed to the underlying format loader and its meaning and format depend on the loader. For example the format string for the .3ds loader accepts the following options:

  • ForceSmooth - average normals for a smooth appearance
  • ForceFaceted - per face normals for a faceted appearance
  • NativeIndices - map native indices for poorly smoothed models
  • CorrectNormals - fix inverted normals on models with bad windings
  • CorrectAcute - fix normals on models that smooth acute angles

The options may be specified globally for the whole model, or just for a particular mesh.

In this example smoothing is forced on globally, and native indices are used on just the mesh called "BattCoverMesh".

 QString op = "ForceSmooth BattCoverMesh=NativeIndices";
QString url = "http://www.example.url.com/music-player.3ds";
QGLAbstractScene *scene = QGLAbstractScene::loadScene(url, QString(), op);

Returns the scene object, or null if the scene could not be loaded or the format was not supported by any of the plugins.

The scene object returned by this will contain only a single stub node at the root of the scenegraph, which will be filled out later once the asynchronous download of the scene data is complete.

See also QGLSceneFormatPlugin.

QGLAbstractScene * QGLAbstractScene::loadScene ( QIODevice * device, const QUrl & url, const QString & format = QString(), const QString & options = QString() ) [static]

Loads a scene from device in the specified format using the registered scene format plugins. If format is an empty string, then the format will be autodetected from the filename extension of device. The url specifies the location of the data in device so that relative resources can be located.

The options string is passed to the underlying format loader and its meaning and format depend on the loader. For example the format string for the .3ds loader accepts the following options:

  • ForceSmooth - average normals for a smooth appearance
  • ForceFaceted - per face normals for a faceted appearance
  • NativeIndices - map native indices for poorly smoothed models
  • CorrectNormals - fix inverted normals on models with bad windings
  • CorrectAcute - fix normals on models that smooth acute angles

The options may be specified globally for the whole model, or just for a particular mesh.

In this example smoothing is forced on globally, and native indices are used on just the mesh called "BattCoverMesh".

 QString op = "ForceSmooth BattCoverMesh=NativeIndices";
QString file = "music-player.3ds";
QGLAbstractScene *scene = QGLAbstractScene::loadScene(file, QString(), op);

Returns the scene object, or null if the scene could not be loaded or the format was not supported by any of the plugins.

To debug scene loading export the environment variable QT3D_DEBUG_MODEL, and (depending on backend implementation) the loader can produce useful debugging information on the console.

See also QGLSceneFormatPlugin.

QGLAbstractScene * QGLAbstractScene::loadScene ( const QString & fileName, const QString &format = QString(), const QString & options = QString() ) [static]

Loads a scene from fileName in the specified format, with the supplied options, and using the registered scene format plugins.

If format is an empty string, then the format will be autodetected from the extension of fileName.

The options string is passed to the underlying format loader and its meaning and format depend on the loader. See the doc above for loadScene() for details on the 3ds format options.

Returns the scene object, or null if the scene could not be loaded or the format was not supported by any of the plugins.

See also QGLSceneFormatPlugin.

QGLSceneNode * QGLAbstractScene::mainNode () const [pure virtual]

Returns the main mesh node in the scene, or null if the scene does not contain a main mesh node.

See also objects().

int QGLAbstractScene::nextPickId ()

Increments and returns the next available pick id for this scene.

QObject * QGLAbstractScene::object ( const QString & name ) const [virtual]

Returns the scene object that has the specified name; or null if the object was not found.

The default implementation searches objects() for an object that matches name.

See also objects().

QStringList QGLAbstractScene::objectNames () const [virtual]

Returns a list of the names of all objects in the scene which are considered important, and which have non-empty names associated with them.

The default implementation calls objects() and then compiles a list of all non-empty object names.

See also objects().

QList<QObject *> QGLAbstractScene::objects () const [pure virtual]

Returns a list of all objects in the scene which are considered important.

Important objects will typically be the main mesh object, cameras, lights, and other top-level objects. Sub-meshes and effects are normally not considered important unless the scene is acting as a library of meshes and effects.

See also objectNames(), object(), and mainNode().

QList<QGLPickNode *> QGLAbstractScene::pickNodes () const

Returns a list of the pick nodes that have been parented onto this scene.

See also generatePickNodes().

bool QGLAbstractScene::pickable () const [virtual]

Returns true if this scene is pickable.

See also setPickable().

void QGLAbstractScene::setPickable ( bool enable ) [virtual]

Sets this scene to be pickable if enable is true, otherwise picking is disabled. If the scene is set to be pickable, pick nodes are generated by calling generatePickNodes().

See also generatePickNodes() and pickable().

QStringList QGLAbstractScene::supportedFormats ( FormatListType t = AsFilter ) [static]

Returns a list of all supported formats known by currently available sceneformat plugins, in the format type t.

If t is QGLAbstractScene::AsFilter then the result may be passed to QDir::setNameFilters(), or used in other filters. This is the default.

For example to create a file dialog to load model files use this:

 QString modelsDir = QDir::toNativeSeperators(QDir::homePath());
QString filter = tr("Models (%1)").arg(QAbstractScene::supportedFormats().join(" "));
QString fileName = QFileDialog::getOpenFileName(this,
tr("Open File"), modelsDir, filter));

Otherwise (when t is QGLAbstractScene::AsSuffix) it is simply a list of file name suffixes.

Note that this function may be expensive to call since it scans for available plugins, and loads each one it finds to get an accurate report of formats supported at run-time.

(Qt 翻译) QGLAbstractScene的更多相关文章

  1. qt翻译和国际化的探讨。

    这段时间一直都在怼qt的国际化,以前也接触过国际化,但是感觉不是那么的深刻,这次是因为一个项目要做一个国际化的版本,代码里面是不能出现中文的,所以就翻译了一下.qt用的是4.8.6 64位的,IDE( ...

  2. (Qt 翻译) QGLSceneNode

    #include <QGLSceneNode> QGLSceneNode ( QObject * parent = 0 ) QGLSceneNode ( const QGeometryDa ...

  3. Qt翻译---Thread Support in Qt

    Thread Support in Qt QT提供线程支持在平台独立的线程类.一个安全线程的传递事件的方式,一个信号槽的链接在线程之中.这使得开发多线程容易.多线程程序也是一个有用的范例为不冻结用户界 ...

  4. qt翻译--QWaitCondition

    QWaitCondition Class Reference[QtCore module] 该类提供一个情况变量来同步线程. #include <QWaitCondition> 注意:该类 ...

  5. qt 国际化(翻译时会触发changeEvent)

    1. 修改工程文件 .pro ,加入翻译源文件 hello_world.ts: TRANSLATIONS += \        Resource/translations/hello_world.t ...

  6. Qt 本地化(翻译)

    Qt 本地化(翻译) 翻译流程大致是这样的:首先源代码产生 ts 文件,然后送给 Qt Linguist(Qt 语言家)这个 Qt 自带的小工具进行处理产生 qm 翻译文件,最后源代码里加载这个 qm ...

  7. Qt Installer Framework翻译(5-4)

    自定义安装程序 您可以使用脚本通过以下方式来自定义安装程序: > 添加Qt Installer Framework操作,该操作由脚本提供,并由安装程序执行. > 添加新页面,该页面由您在p ...

  8. Qt学习之路(34): 国际化(下)

      原创作品,允许转载,转载时请务必以超链接形式标明文章 原始出处 .作者信息和本声明.否则将追究法律责任.http://devbean.blog.51cto.com/448512/245063 上次 ...

  9. Qt多国语言QT_TR_NOOP和QT_TRANSLATE_NOOP

    文章来源:http://devbean.blog.51cto.com/448512/245063/ 在代码中,我们使用tr()将需要翻译的字符串标记出来.lupdate工具就是提取出tr()函数中的相 ...

随机推荐

  1. Android studio教程:[6]创建多个Activity

    通常来说,一个android应用程序不止一个Activity(活动),更不止一个界面.于是需要创建多个Activity来满足应用程序的要求,这里我将告诉大家如何添加新的Activity,并实现Acti ...

  2. thinkPHP入门 一

    简介 ThinkPHP是一个快速.简单的基于MVC和面向对象的轻量级PHP开发框架,遵循Apache2开源协议发布,从诞生以来一直秉承简洁实用的设计原则,在保持出色的性能和至简的代码的同时,尤其注重开 ...

  3. linux学习笔记之进程

    一.基础知识 1:进程. 1,进程ID: 非负整数,具有唯一性. 1)ID=0的进程:调度进程/交换进程.内核的一部分.不执行任何磁盘上的程序. 2)ID=1的进程:init进程. 1-自举结束时,由 ...

  4. linux学习笔记之sudo

    引用A:http://blog.chinaunix.net/uid-15811445-id-149961.html 引用B:http://os.51cto.com/art/201307/404879. ...

  5. Bluestacks视窗界面调整及内存调整经验

    本文将分享bluestacks视窗界面调整及内存调整的经验,可以有效解决Bluestacks缓慢.卡的问题! 一.bluestacks视窗界面调整 1.进入注册表: 2.找到下图中的键值: 3.修改键 ...

  6. 使用pymysql连接MySql数据库

    MySQLdb安装失败了,直接使用pymysql,安装了pymysql. 并学习了使用使用pymysql创建数据库和表,并插入数据. __author__ = 'Administrator' impo ...

  7. Ubuntu系统下创建python数据挖掘虚拟环境

    虚拟环境:   虚拟环境是用于创建独立的python环境,允许我们使用不同的python模块和版本,而不混淆.   让我们了解一下产品研发过程中虚拟环境的必要性,在python项目中,显然经常要使用不 ...

  8. c语言函数注意点

    返回值的基本概念.return的作用    return 1>void可以省略return 2>可以多次使用return 3>return后面不能有其他语句   4. 函数的弱语法 ...

  9. Azure File SMB3.0文件共享服务(2)

    使用Powershell创建文件共享 Azure的文件存储结构如下所示,最基本的文件存储包含存储账号,文件共享,在文件共享下面你可以建立文件目录,上传文件: 在开始使用Powershell创建文件共享 ...

  10. Android Studio中获取sha1证书指纹数据的方法

    高德地图开发申请KEY的时候需要开发者提供SHA1证书指纹数据,在eclipse很容易就找到了,但是Android Studio很久也没找到,只能使用在网上看到的方法了,在Android Studio ...