Yamyam: 1版をインポートしました

2018-06-28T21:04:27Z

1版をインポートしました

wiki>Jwilkins: Created page with "= GPU API Safety Checks = == WITH_GPU_SAFETY == Building ''Blender'' with the ''WITH_GPU_SAFETY'' option turned on will enable a lot of extra checks which help to ensure that ..."

2013-09-23T23:38:01Z

Created page with "= GPU API Safety Checks = == WITH_GPU_SAFETY == Building ''Blender'' with the ''WITH_GPU_SAFETY'' option turned on will enable a lot of extra checks which help to ensure that ..."

新規ページ

= GPU API Safety Checks =

== WITH_GPU_SAFETY ==

Building ''Blender'' with the ''WITH_GPU_SAFETY'' option turned on
will enable a lot of extra checks which help to ensure that the
graphics API is being used correctly.

'''No ''GPU_SAFETY'' check should ever fail!'''

For that reason it is preferable that the ''WITH_ASSERT_ABORT'' option
is also enabled. Since this will trigger a break point and allow
the state of ''Blender'' to be preserved enough that the reason for
the failure can be determined.

== Macros ==

Header File: <tt>GPU_safety.h</tt>

The <tt>GPU_SAFETY</tt> macro is defined to either 0 or 1 depending on if WITH_GPU_SAFETY is defined.

The <tt>GPU_ASSERT(pred)</tt> macro will abort the program if <tt>pred</tt> is false.
The <tt>pred</tt> will never be executed if <tt>WITH_GPU_SAFETY</tt> is disabled so do not place code that always needs to execute inside of <tt>GPU_ASSERT</tt>.

<tt>GPU_ABORT()</tt> will unconditionally <tt>abort</tt> ''Blender'' if execution reaches it and <tt>WITH_GPU_SAFETY</tt> is enabled.

The <tt>GPU_CHECK_NO_ERROR()</tt> is strategically placed throughout the code to make sure that there are no unchecked ''OpenGL'' errors.
Code that directly calls ''OpenGL'' should have a <tt>GPU_CHECK_NO_ERROR()</tt> before and after those calls.
However, there is no need to check every single ''OpenGL'' call (at that would be both tedious and make reading the code difficult).
The goal is that any misuse of the ''OpenGL'' API will be cause immediately and close to where the error occurred.
''OpenGL'' errors are almost all caused by misuse of the API (akin to a syntax error) and not by runtime problems (such as an out of memory error).

<tt>GPU_CHECK(expr)</tt> is equivalent to putting <tt>GPU_CHECK_NO_ERROR()</tt> before and after a function.
Unlike <tt>GPU_ASSERT()</tt> the <tt>expr</tt> will not disappear in non-debug builds.

← 古い版	2018年6月28日 (木) 21:04時点における版
(相違点なし)

利用者:Jwilkins/VFX/Misc/Safety - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Jwilkins: Created page with "= GPU API Safety Checks = == WITH_GPU_SAFETY == Building ''Blender'' with the ''WITH_GPU_SAFETY'' option turned on will enable a lot of extra checks which help to ensure that ..."

Yamyam: 1版をインポートしました