switch root namespace name to NITLOAD

2026-09-02 18:15:03 +08:00
parent 4218baad48
commit 7c7101ee48
502 changed files with 710 additions and 721 deletions
@@ -0,0 +1,67 @@
+# StgSharp.Graphics retired sources
+
+This directory contains source snapshots retired during the Graphics/OpenGL
+reorganization on 2026-08-26. Files use the `.cs.old` suffix so that SDK-style
+project globbing does not compile them.
+
+## Retired without an active replacement
+
+- `framework.cs.old`: unused GL/debug delegate declarations.
+- `Vulkan.*.cs.old`: unreferenced Vulkan placeholders.
+- `OpenGL.glRenderStream.ThreadSecurity.cs.old`: unused thread/context fields.
+- `OpenGL.Generated.GlCommandHistory.g.cs.old`: generator report data that does
+  not belong in the runtime assembly.
+
+## Split before retirement
+
+- `gl.cs.old`: image P/Invokes were temporarily split out and later retired;
+  legacy OpenGL native helpers were replaced with direct calls through the
+  OpenGL function table.
+- `glfw.dtruct.cs.old`: reduced to the four opaque GLFW types currently used by
+  the wrapper in `glfw.struct.cs`.
+- `OpenGL.glType.cs.old`: only `glSync` remains active in `OpenGL/glSync.cs`.
+- `ShaderEdit.ShaderGenerator.cs.old`: only the temporary
+  `InternalShaderType` compatibility enum remains active.
+- `GraphicInitializer.cs.old`: merged into the correctly named `GraphicModule`
+  in `glfw.cs`.
+- `OpenGL.glApiManager.cs.old` and `OpenGL.glApiManager.Const.cs.old`: the active
+  compatibility loader retains only core-version loading; the unused extension
+  classification table and 619 write-only flags were retired.
+
+## Retired during the image simplification
+
+- `Image.cs.old`: the former image/decoder/OpenGL-format aggregate.
+- `ImageInfo.cs.old` and `Image.Native.cs.old`: the mismatched native decoder
+  state and its P/Invoke bridge.
+- `Pixels.cs.old`: the unused and incorrectly sized legacy pixel abstraction.
+- `CPUanimation.ImageHelper.cs.old`: incomplete resizing and movement logic;
+  image transformations now belong to a caller-selected codec or image library.
+- `CPUanimation.IImageProvider.cs.old`: the redundant image-returns-itself
+  provider contract.
+- `TexturePipeline.cs.old`: an unused pipeline payload tied to the retired
+  non-generic image type.
+- `OpenGL.Buffer.AutoTexture.cs.old`: the unused texture cache depended on image
+  mutation counters and also contained incorrect slot/recycling bookkeeping.
+
+## Retired during the data-only OpenGL resource migration
+
+- `Define.BufferObjectBase.cs.old` and
+  `OpenGL.Buffer.GLBufferObjectBase.cs.old`: the former resource base classes
+  injected `glRender`/`OpenGLFunction` and attempted context-bound disposal from
+  resource objects and finalizers.
+- `OpenGL.glRenderObjectGenrator.cs.old`: the former factories implicitly
+  created resources through a render-stream instance.
+- `OpenGL.ShaderEdit.IglConvertable.cs.old`, `ShaderEdit.ShaderStruct.cs.old`,
+  and `ShaderEdit.InternalShaderType.cs.old`: the obsolete shader conversion
+  layer submitted uniforms through the global `CurrentGL` context.
+
+Active OpenGL resource and shader types are passive handle records. Creation,
+binding, upload, compilation, use, and deletion are explicitly submitted to an
+`OpenGLFunction` instance.
+
+The active `Image<TPixel>` is only a tightly packed managed bitmap buffer. It
+does not load files, convert formats, resize pixels, or retain native memory.
+
+These files are historical references, not candidates for restoration as a
+group. Restore individual behavior only after checking it against the new
+Graphics and OpenGL architecture.