CSharpGL wraps modern OpenGL features and some high-level common functions(text, scene, picking, UI etc) and offers general demostrations and documents. Inspired by SharpGL. For more information please check (http://bitzhuwei.github.io/CSharpGL/)

Install-Package CSharpGL -Version
dotnet add package CSharpGL --version
paket add CSharpGL --version
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

# CSharpGL
CSharpGL wraps OpenGL features(VBO, shader, scene, picking, UI, text etc) and offers general demostrations and documents.  
For more information please check (http://bitzhuwei.github.io/CSharpGL/)

# release notes:
## v1.0.7.4:
1. fix: static `Win32` initialization.
2. fix: IndependentBufferTarget : uint
3. `Buffer` allows for shadow copy.
4. Any struct\managed array\unmanaged array can be uploaded to server side directly.

## v1.0.7.3:
1. redefine `Buffer`: Buffer is buffer, there is no buffer pointer.
2. `BitmapFilter` supports multiple levels.
3. fix: `RendererBase.GetModelMatrix()`.

## v1.0.7.2:
1. Directly create buffer on server side(GPU).
2. `ClearBufferData` and `ClearBufferSubData`.
3. fix: cascade model matrix.
4. `OpenGL.GetDelegateFor<T>()` logs but not throw an exception when some OpenGL command is not supported on specific device.

## v1.0.7.1:
1. rename `IColorCodedPicking` to `IPickable`.
2. `Markable` struct supports timestamp when member is updated.
3. Cascade model matrix.(`IModelSpace` keeps relative model space to parent node.)
4. Quick sort algorithm of `UnmanagedArray<T>`.
5. `VertexAttributeBuffer` supports `glVertexAttribPointer`, `glVertexAttribIPointer` and `glVertexAttribLPointer`.

## v1.0.7.0:
1. DitherSwitch\LogicOperationSwitch\AlphaFuncSwitch.
2. Support uniform struct.
3. Remove opengl version attribute in `GLCanvas`.
4. fix: return first `lastIndexId` object when picking a point.
5. Generic `ILayout<T>` separated from `UIRenderer`.
6. `ViewPort` supports `ILayout<ViewPort>`(tree layout). `Scene` supports multiple view ports.
7. `ViewPort` integrated in picking.
8. Use opengl window coordinate system in picking.

## v1.0.6.8:
1. `UniformVariable` need not to reset.
2. `ClipPlaneSwitch` only works in Legacy OpenGL.
3. `UniformBlock<T>` supports uniform block in GLSL.
4. fix: Fields of `vec4` layout in the order `x, y, z, w` to match that in GLSL.
5. `glm.inverse()` and `glm.transpose()`.

## v1.0.6.7:
1. fix: glm.rotate(angle, axis) uses angle in degrees(same as glRotatef() in legacy OpenGL).
2. Tranform between matrix and (angle+axis) via Quaternion.
3. VAO with no vertex attribute buffer is allowed.
4. `ShaderStorageBuffer` 'is an' `IndependentBuffer`.
5. `CubemapImageFiller` for creating a cubemap texture.
6. `FrontFaceSwitch`.

## v1.0.6.6:
1. More switces(DepthMask, ColorMask, StencilMask).
2. Query object supports conditional rendering.
3. fix: remove framebuffer object in ColorCodedPicking.
4. `Buffer` supports bind/unbind and abstract Target property.
5. `Renderer` always renders with its own index buffer.
6. LineStippleSwitch and PolygonStippleSwitch.
7. Bezier curve rendering with legacy OpenGL.
8. Color-coded picking intergrated in Scene.
9. VertexAttributeBuffer supports tessellation shaders.
10. Remove self defined cursor in scene.
11. fix: Inner pickable Renderer takes model matrix into consideration when moving vertex's positions.
12. Remove mat4 MVP in IColorCodedPicking.
13. fix: missed the condition of picking a point when rendering GL_POINTS.

## v1.0.6.5:
1. Uniform/Texture/AtomicCounter/PixelUnpack Buffer.
2. Create Texture filled with Buffer(uniform samplerBuffer in GLSL shader).
3. Rename PropertyBuffer to VertexAttributeBuffer.
4. VertexAttributeBuffer supports instanced-rendering.
5. VertexAttributeConfig decides parameters' values in glVertexAttribPointer(attributeLocation, size, type, false, 0, IntPtr.Zero);
6. fix: logic error in InnerPickableRenderer.DoInitialize().
7. Map/Unmap buffer in VertexAttributeBuffer, IndependentBuffer and OneIndexBuffer.

## v1.0.6.4:
1. IModelSpace consists of position, scale and rotation.
2. Get quaternion from model matrix.
3. Wraps framebuffer and use framebuffer in GLCanvas and Color-Coded picking.
4. Add NullImageBuilder for Texture.
5. Add IndependentBuffer(Ptr).
6. Remove useless enumerations.
7. Clean code with CodeMaid.
8. Renderer.SetUniform() throws exception when wrong type of value is fed in.
9. The ICanvas interface abstracts winform controls.
10. Add 'bool UsesZeroIndexBuffer()' in IBufferable.
11. Bind/Unbind buffer.
12. Initialize VAO inside Renderer's initializing.
13. Auto-allocate memory in UnmanagedArray.

## v1.0.6.3:
1. fix: BoundingBoxHelper.Render().
2. virtual DoUpdate() in Script instead of abstract.
3. fix: discard transparent part in glyph.
4. Scene.Update once.
5. Scene only has script component.
6. SceneRootObject as root object in scene.
7. Update+Render scene whenever property is changed.
8. Bigger font for property grid.
9. Renderer supports IModelSpace.
10. Zooming camera updates camera's position and target only.
11. Model matrix should be marked as updated at first.

## v1.0.6.2:
1. Wraps texture and sampler.
2. IModelSpace provides model matrix for rendering in MVP matrix in shader.
3. fix: Scene renders all objects recursively.
4. Remove initialize method in ScriptComponent because scripts may be executed in non-UI thread.

## v1.0.6.1:
1. fix: rename NewTexture to Texutre.
2. Sampler works.

## v1.0.6.0:
1. IModelSpace transforms a model from model's sapce to world's sapce.
2. Start/Stop scene.
3. fix: LabelRenderer supports updating text right before rendering.
4. New project for generating Renderer types.(check CSharpGL on GitHub)
5. Wrapped types(Texture, Sampler and ImageFiller) for texture's construction, initialization and destroy.

## v1.0.5.2:
1. Add default cursor(an UI element) into Scene.
2. Hide/Show system's cursor in GLCanvas.
3. fix: update UIRoot's size when scene is resized.
4. TransformComponent is no longer a field member in SceneObject.
5. IModelSpace transform a model from model's sapce to world's space.

## v1.0.5.1:
1. TextureUpdater allows for updating texture's content.
2. Better looking for Axis and UIAxis.
3. Remove useless TTF file in resource.
4. UICursor renders a cursor with texture.

## v1.0.5.0:
1. Better solution of printing FonBitmap.
2. Fix: no need to check if uniform variable exists in shader when during SetUniform().
3. Add BeforeLayout and AfterLayout event for UIRenderer.

## v1.0.4.13:
1. Mapping uniform type ivec2/3/4, uvec2/3/4, bvec2/3/4 types.
2. Generic type converter for struct types.
3. DefaultFramebuffer creates framebuffer for canvas.
4. Fix bug: UIText supports all colors.
5. Remove namespace System.
6. Simpler solution(System.Drawing.Font.MeasureString()) for displaying text. (SharpFont not needed, thus much less code.)

## v1.0.4.12:
1. Add ArcBallManipulater to rotate model.
2. All types for SharpFont are private.
3. Remove all GLU functions and constants.
4. Remove wraper functions for legacy OpenGL.
5. Single instance pattern for Win32.
6. Remove constants in Win32 that are not used.
7. Resize GLCanvas only when the control is resized.
8. Allows for refresh canditate types in FormSelectType.
9. Remove unnecessray dictionary.
10. TypeHelper helps to create instance of specified type.
11. Display a clock in GLCanvas in design mode.
12. Fix bug in LabelRenderer which allows to define size in pixel.
13. Add uniform type for Int32.
14. UniformArrayVariable will be marked as Updated whenever its item is updated.
15. Use reflection to get all uniform types and uniform array types.
16. Comment some OpenGL contants that are never used.
17. Enumeration type for glGetString.
18. PositionHelper returns a IBoundingBox of specified position array.
19. UpdatingRecord records time when a property is updated or uploaded.
20. BoundingBoxRenderer renders a bounding box.
21. IBoundingBox and ICamera supports adjusting camera's position and target.

## v1.0.4.11:
1. Remove FUint, Rect, ResizableArray etc from SharpFont.
2. Organize FontResource's code.
3. Manipulaters' BindingMouseButtons response to all possible buttons.

## v1.0.4.10:
1. Simpler Scene: remove useless UIRootRendererComponent; UIRoot rendering ui for Scene.
2. PositionHelper.Move2Center() supports vec2.
3. Retarget CSharpGL's .net version to .net3.5.
4. Fix bug in ILyaout.NonRootNodeLayout().
5. Remove SatelliteRotator.
6. Rename RenderEventArgs to RenderEventArg.
7. mat4Helper converts float array to mat4.
8. Fix bug in get delegate for OpenGL command.(Use proc.ToInt64() instead of proc.ToInt32())
9. Camera manipulaters using mouse/keyboard.
10. Better performance: reading GL_DEPTH_COMPONENT to make sure something is picked.
11. ChildList<T> represents children in ITreeNode<T>.
12. IndexBufferEditor displays controller for update parameters for glDrawArrays() or glDrawElements().
13: Release bind element buffer in OneIndexBuffer.
14. Comment debug lines in FontResource.
15. TextModel allows for updating text property.

## v1.0.4.9:
1. 3 PolygonOffsetSwitch types for Fill, Line and Point.
2. remove unnecessary initialization of creating PrimitiveRestartSwitch for OneIndexRenderer.
3. Rename GLRoot/GLAxis/GLText to UIRoot/UIAxis/UIText.
4. UI types manage its uniform variables inside.
5. ILayout derived from ITreeNode<UIRenderer>.
6. UIRoot auto-layout before rendering.
7. UIRendererComponent manages UI objects in the Scene.
8. FormIListEditor supports creating instance with parameters.
9. PositionHelper.Move2Center() operates on input parameters.

## v1.0.4.8:
1. SceneObject maintains a list of script components.
2. Generic List Editor for different list types.
3. Move item up/down in generic list editor.
4. Display uniform variable's location in property grid.
5. Add ItemAdded/ItemRemoved events.
6. Explicit implement of ITreeNode<SceneObject> for SceneObject.
7. Remove the complex error-prone relative transform properties.

## v1.0.4.7:
1. Enable/Disable SceneObject controls whether it takes part in rendering and updating.
2. SceneObject's transform(position/scale/rotation) is updated according to parent/child relation then to script component.
3. Sphere supports uv mapping attribute.
4. SatelliteManipulater manipulates camera's posiiton, rotation and distance to target. Camera acts like a sateliite moving around its target when manipulated by SatelliteManipulater.
5. Rename vec2/vec3/vec4.Magnitude() -> length().
6. LabelRenderer renders a text label in 3D world space. The text can be updated in runtime.
7. Fix bug: teapot's face property buffer.
8. Fix bug: FontResource should provide seperate default instances for different render contexts.

## v1.0.4.6:
1. FormSelectType loads specified types from all loaded assemblies and cache them.
2. TransformCompoent and ScriptComponent works simiar to those in Unity.

## v1.0.4.5:
1. Scene object and components learnt from Unity.
2. UITypeEditor for Camera, Scene types.
3. OpenGLVersion Only works in design mode.
4. No need check value type for UniformValue in release mode.
5. Add Cube, Sphere and Ground as buil-in Scene-Object.
6. Update color algorithm for cube and sphere.
7. Remove unnecessary versions of GetViewMat4().
8. FirstPerspectiveManipulater allows for move camera by key event and mouse event.

## v1.0.4.2:
1. Stronger Camera class: Get directions.
2. Faster glm.lookAt().
3. CSSL integrates all build-in funcitons from GLSL shader pdf(not into CSharpGL)
4. Easier to use GLControl as root UI renderer.(Auto-bind to canvas' resize event)
5. Clean interface and implementation for FontResource.
6. Update frame buffer constants.
7. Remove unused resources(teapot.obj etc.) to reduce CSharpGL.dll's file size.
8. internal fields of mat2/mat3/mat4 for better performance.

## v1.0.4.1:
1. integrate all uniform variables and array variables inheriting from UniformVariable.

## v1.0.4.0:
1. Renderer supports setup uniform array variable.(uniform vec3 positions[10];)
2. Different kinds of uniform arrays: float[], vec2[], vec3[], vec4[], mat2[], mat3[],mat4[], samplerValue[].

## v1.0.3.0:
1. Get a Font Resource from TTF files.
2. Font Resource supports rendering text.

## v1.0.2.0:
1. GLControls allows for control-style objects.
2. A GLAxis and GLText control.
3. More OpenGL switches and uniforms.

## v1.0.1.0:
1. Only pickable Renderer check if position buffer's DataSize is 3.
2. Adjust camera's default settings.
3. OneIndexBuffer can controls the first element to be rendered.

## v1.0.0.9:
1. supports picking of point, line and basic geometry(triangle, quad, polygon) from any kind of OneIndexRenderer or ZeroIndexRenderer.
2. rename *ModernRenderer*.cs to *Renderer*.cs
3. fix bug in QuadStripRecoginzer: reorder its vertexs to form a quad.(0 1 2 3 -> 0 1 3 2)

## v1.0.0.2:
1. add model: BigDipper, Tetrahedron, Cube, Sphere, Teapot.

## v1.0.0.1:
1. Modern rendering(Shader+VBO).
2. Color-coded-picking of primitives in a VBO.
3. Highlight picked primitives.
4. Draw text using `glRasterPos()` and `CallList`.
5. `PolygonOffsetSwitch`.
6. `ILayout` supports layout UI element in an OpenGL canvas.


This package has no dependencies.

Version History

Version Downloads Last updated (current) 785 11/17/2016 156 11/11/2016 168 11/2/2016 217 10/26/2016
1.0.7 167 10/13/2016 166 9/28/2016 170 9/23/2016 194 9/20/2016 161 9/13/2016 207 9/8/2016 245 8/26/2016 216 8/21/2016 214 8/12/2016
1.0.6 199 8/12/2016 156 8/9/2016 213 8/7/2016
1.0.5 161 8/2/2016 213 7/30/2016 375 7/15/2016 232 7/6/2016 246 6/30/2016 230 6/22/2016 234 6/21/2016 261 6/20/2016 236 6/18/2016 233 6/17/2016 237 6/14/2016 419 6/9/2016
1.0.4 248 6/8/2016
1.0.3 263 6/4/2016
1.0.2 226 6/1/2016
1.0.1 223 5/13/2016 220 5/3/2016 244 4/29/2016 219 4/29/2016