direct.filter.CommonFilters

from direct.filter.CommonFilters import CommonFilters, FilterConfig

Class CommonFilters implements certain common image postprocessing filters. See the Common Image Filters page for more information about how to use these filters.

These filters are written in the Cg shading language.

Inheritance diagram

class CommonFilters(win, cam)

Bases: object

Class CommonFilters implements certain common image postprocessing filters. The constructor requires a filter builder as a parameter.

__init__(self, win, cam)

cleanup(self)

delAmbientOcclusion(self)

delBloom(self)

delBlurSharpen(self)

delCartoonInk(self)

delExposureAdjust(self)

delGammaAdjust(self)

delHalfPixelShift(self)

delHighDynamicRange(self)

delInverted(self)

delMSAA(self)

delSrgbEncode(self)

Reverses the effects of setSrgbEncode.

delViewGlow(self)

delVolumetricLighting(self)

reconfigure(self, fullrebuild, changed)

Reconfigure is called whenever any configuration change is made.

setAmbientOcclusion(self, numsamples=16, radius=0.05, amount=2.0, strength=0.01, falloff=2e-06)

setBloom(self, blend=(0.3, 0.4, 0.3, 0.0), mintrigger=0.6, maxtrigger=1.0, desat=0.6, intensity=1.0, size='medium')

Applies the Bloom filter to the output. size can either be “off”, “small”, “medium”, or “large”. Setting size to “off” will remove the Bloom filter.

setBlurSharpen(self, amount=0.0)

Enables the blur/sharpen filter. If the ‘amount’ parameter is 1.0, it will not have any effect. A value of 0.0 means fully blurred, and a value higher than 1.0 sharpens the image.

setCartoonInk(self, separation=1, color=(0, 0, 0, 1))

setExposureAdjust(self, stops)

Sets a relative exposure adjustment to multiply with the result of rendering the scene, in stops. A value of 0 means no adjustment, a positive value will result in a brighter image. Useful in conjunction with HDR, see setHighDynamicRange.

New in version 1.10.7.

setGammaAdjust(self, gamma)

Applies additional gamma correction to the image. 1.0 = no correction.

setHalfPixelShift(self)

setHighDynamicRange(self)

Enables HDR rendering by using a floating-point framebuffer, disabling color clamping on the main scene, and applying a tone map operator (ACES).

It may also be necessary to use setExposureAdjust to perform exposure compensation on the scene, depending on the lighting intensity.

New in version 1.10.7.

setInverted(self)

setMSAA(self, samples)

Enables multisample anti-aliasing on the render-to-texture buffer. If you enable this, it is recommended to leave any multisample request on the main framebuffer OFF (ie. don’t set framebuffer-multisample true in Config.prc), since it would be a waste of resources otherwise.

New in version 1.10.13.

setSrgbEncode(self, force=False)

Applies the inverse sRGB EOTF to the output, unless the window already has an sRGB framebuffer, in which case this filter refuses to apply, to prevent accidental double-application.

Set the force argument to True to force it to be applied in all cases.

New in version 1.10.7.

setViewGlow(self)

setVolumetricLighting(self, caster, numsamples=32, density=5.0, decay=0.1, exposure=0.1, source='color')

update(self, task=None)

Updates the shader inputs that need to be updated every frame. Normally, you shouldn’t call this, it’s being called in a task.

class FilterConfig

Bases: object