flutter3d_post 1.0.0-rc.2
flutter3d_post: ^1.0.0-rc.2 copied to clipboard
Post-processing for flutter3d, one library per family: light, shading, reflections, atmosphere, motion and style, and a standard preset of all six. Each effect is a plugin.
1.0.0-rc.2 #
-
Breaking: the sky and the outlines are steps in this package's namespace.
outlinesStepandskyStepareflutter3d_post.skyandflutter3d_post.outlines, where they had no namespace: every name a plugin registers carries one, and a structure rule now holds it. Code that found them by name uses the new words. -
Breaking: each effect's plugin id is this package's.
BloomAddonisflutter3d_post.bloom, and so on for all 23, where they wereflutter3d_addon_light.bloomand the like; the three reflections areflutter3d_post.screen_space_reflections,planar_reflectionsandreflection_probes, and the grade isflutter3d_post.color_grade. A run recorded under the old ids reads as naming the new ones. -
Breaking: a family's library does not re-export its settings.
FogSettings,BloomSettings,MotionBlurSettings,ReflectionSettings,PlanarReflectorNode,ReflectionProbeNode,AmbientOcclusionSettings,HighContrastSettings,SettingsSlotand the rest areflutter3d_core's, imported from there or throughflutter3d. -
Its plugins are marked with
flutter3d_plugins:(decision D), the key pub does not warn about. -
New: one package for what was seven.
flutter3d_addon_light,flutter3d_addon_shading,flutter3d_addon_reflections,flutter3d_addon_atmosphere,flutter3d_addon_motion,flutter3d_addon_style,flutter3d_addons_standardare libraries of this package now:light.dart,shading.dart,reflections.dart,atmosphere.dart,motion.dart,style.dart,standard.dart, each with the API its package had, andflutter3d_post.dartexports them all.dart run flutter3d_build:migratemoves a project's dependencies and imports; the packages' own histories are indoc/changelogs/. -
One plugin marker per library. The families' plugins are listed under their libraries in
flutter3d: plugin:, which discovery now reads as a map of library to classes, so one dependency installs every effect as a switch, as the standard preset did.
light.dart, from flutter3d_addon_light 1.0.0-rc.1 #
-
Breaking: American spelling in identifiers, as Flutter and Dart use.
ColourGradeAddonisColorGradeAddon. Only the Dart names changed: a file keeps the keys it was written with, anddart fixcarries the renames. -
The light family as plugins.
BloomAddon,LensFlareAddon,AutoExposureAddon,LocalExposureAddon,ColorGradeAddon,LensDistortionAddonandVignetteAndGrainAddon, all inlightAddons. Each is a view plugin on plugin API 1.0 and the switch of one render step. The lens flare depends on the bloom. -
Each plugin names the settings it reads. The family's addons add
SettingsSlot.bloom,look,autoExposureandlocalExposureto the renderer while on, soRendererSteps.settingslists them, and this library exportsSettingsSlot. The types stay defined influtter3d_core, which reads them as fields ofRenderSettings. -
Installing them changes nothing. The kernel still draws the passes, with the settings it always had. Switching a plugin off withdraws its step from every frame, and
FrameResult.skippedreports it as switched off. A renderer with no addon installed draws what it always drew. -
The family's settings in one import.
BloomSettings,LensFlareSettings,AutoExposureSettings,ExposureMeter,ExposureAdapter,LocalExposureSettingsandLookSettingsare exported here. They are still defined influtter3d_core, so existing imports keep compiling.
shading.dart, from flutter3d_addon_shading 1.0.0-rc.1 #
-
The shading family as plugins.
AmbientOcclusionAddonandContactShadowsAddon, both inshadingAddons. Each is a view plugin on plugin API 1.0 and the switch of one render step. -
Each plugin names the settings it reads. The family's addons add
SettingsSlot.ambientOcclusionandcontactShadowsto the renderer while on, soRendererSteps.settingslists them, and this library exportsSettingsSlot. The types stay defined influtter3d_core, which reads them as fields ofRenderSettings. -
Installing them changes nothing. The kernel still draws the passes, with the settings it always had. Switching a plugin off withdraws its step from every frame, and
FrameResult.skippedreports it as switched off. A renderer with no addon installed draws what it always drew. -
The family's settings in one import.
AmbientOcclusionSettings,AmbientOcclusionMethodandContactShadowSettingsare exported here. They are still defined influtter3d_core, so existing imports keep compiling.
reflections.dart, from flutter3d_addon_reflections 1.0.0-rc.1 #
-
The reflections family as plugins.
ReflectionProbesAddon,PlanarReflectionsAddonandScreenSpaceReflectionsAddon, all inreflectionsAddons. Each is a view plugin on plugin API 1.0 and the switch of one render step. -
Each plugin names the settings it reads. The family's addons add
SettingsSlot.reflectionsandplanarReflectionsto the renderer while on, soRendererSteps.settingslists them, and this library exportsSettingsSlot. The types stay defined influtter3d_core, which reads them as fields ofRenderSettings. -
Installing them changes nothing. The kernel still draws the passes, with the settings it always had. Switching a plugin off withdraws its step from every frame, and
FrameResult.skippedreports it as switched off. A renderer with no addon installed draws what it always drew. -
The family's settings in one import.
ReflectionSettings,PlanarReflectionSettings,ReflectionProbeNodeandPlanarReflectorNodeare exported here. They are still defined influtter3d_core, so existing imports keep compiling.
atmosphere.dart, from flutter3d_addon_atmosphere 1.0.0-rc.1 #
-
The atmosphere family as plugins.
SkyAddon,FogAddon,VolumetricFogAddonandLightShaftsAddon, all inatmosphereAddons. Each is a view plugin on plugin API 1.0 and the switch of one render step. The fog includes height fog. -
Each plugin names the settings it reads. The family's addons add
SettingsSlot.fog,volumetricFog,lightShaftsandskyto the renderer while on, soRendererSteps.settingslists them, and this library exportsSettingsSlot. The types stay defined influtter3d_core, which reads them as fields ofRenderSettings. -
The sky is a step.
skyStepis this package's own, switched bySkySettings.enabled.SkyAddonadds it to the renderer and provides it, and a frame without it reportsskyas switched off. -
Installing them changes nothing. The kernel still draws the passes, with the settings it always had. Switching a plugin off withdraws its step from every frame, and
FrameResult.skippedreports it as switched off. A renderer with no addon installed draws what it always drew. -
The family's settings in one import.
FogSettings,VolumetricFogSettings,LightShaftSettings,SkySettingsandPhysicalSkyare exported here. They are still defined influtter3d_core, so existing imports keep compiling.
motion.dart, from flutter3d_addon_motion 1.0.0-rc.1 #
-
The motion family as plugins.
DepthOfFieldAddon,MotionBlurAddonandTemporalAntiAliasingAddon, all inmotionAddons. Each is a view plugin on plugin API 1.0 and the switch of one render step. -
Each plugin names the settings it reads. The family's addons add
SettingsSlot.depthOfField,motionBlurandantiAliasto the renderer while on, soRendererSteps.settingslists them, and this library exportsSettingsSlot. The types stay defined influtter3d_core, which reads them as fields ofRenderSettings. -
Installing them changes nothing. The kernel still draws the passes, with the settings it always had. Switching a plugin off withdraws its step from every frame, and
FrameResult.skippedreports it as switched off. A renderer with no addon installed draws what it always drew. -
The family's settings in one import.
DepthOfFieldSettings,MotionBlurSettings,TemporalSettingsandTemporalClipare exported here. They are still defined influtter3d_core, so existing imports keep compiling.
style.dart, from flutter3d_addon_style 1.0.0-rc.1 #
-
The style family as plugins.
HighContrastAddon,OutlinesAddonandViewportShadingAddon, all instyleAddons. Each is a view plugin on plugin API 1.0 and the switch of one render step. The outlines depend on the look. -
Toon lighting is this package's.
toonLightingis the model, andToonLightingAddonregisters it throughLightingModelsthe way a third-party model is registered. It is the same constant as the kernel'sLightingModel.toon, which stays built in for 1.x because the stages are still in every engine bundle: a material namingToondraws with or without the addon. -
Each plugin names the settings it reads.
HighContrastAddonandViewportShadingAddonaddSettingsSlot.highContrastandSettingsSlot.viewportShadingto the renderer while on, and this library exportsSettingsSlot. -
The outlines are a step.
outlinesStepis this package's own, switched byHighContrastSettings.outlineWidthand needingRenderStep.highContrast. Off, the look stays and the rings go. -
Installing them changes nothing. The kernel still draws the passes, with the settings it always had. Switching a plugin off withdraws its step from every frame, and
FrameResult.skippedreports it as switched off. A renderer with no addon installed draws what it always drew. -
The family's settings in one import.
HighContrastSettings,ViewportShadingandViewportShadingSettingsare exported here. They are still defined influtter3d_core, so existing imports keep compiling.
standard.dart, from flutter3d_addons_standard 1.0.0-rc.1 #
-
Breaking: American spelling in identifiers, as Flutter and Dart use.
ColourGradeAddonisColorGradeAddon. Only the Dart names changed: a file keeps the keys it was written with, anddart fixcarries the renames. -
The six post-processing families in one list.
standardAddonsholds all twenty-two plugins offlutter3d_addon_light,_shading,_reflections,_atmosphere,_motionand_style, and this library exports all six. -
Installing it changes nothing about the frame. With the preset installed, the frame order fixture's 244 frames come out byte for byte the same as with no addon. What it adds is a switch for every effect.