J4JSoftware.VisualUtilities 2.0.0

.NET 7.0 This package targets .NET 7.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package J4JSoftware.VisualUtilities --version 2.0.0                

                    
                

            
NuGet\Install-Package J4JSoftware.VisualUtilities -Version 2.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="J4JSoftware.VisualUtilities" Version="2.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add J4JSoftware.VisualUtilities --version 2.0.0                

                    
                

            
#r "nuget: J4JSoftware.VisualUtilities, 2.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install J4JSoftware.VisualUtilities as a Cake Addin
#addin nuget:?package=J4JSoftware.VisualUtilities&version=2.0.0

// Install J4JSoftware.VisualUtilities as a Cake Tool
#tool nuget:?package=J4JSoftware.VisualUtilities&version=2.0.0

J4JSoftware.VisualUtilities

The change log is available here.

The library repository is available on github.

This assembly is focused on functions needed to work with various kinds of media objects.

This assembly targets Net 7 and has nullability enabled.

WebColors

The WebColors class contains various static methods supporting frequently-used transformations between "web-encoded" colors and colors as defined in the Microsoft/Windows environment (the difference relates to how RGB colors are stored within a 32 bit integer value). Using the Google Earth API within a Windows app is an example of where this difference comes into play.

Vector-based and Coordinate System Utilities

I find working with the Windows Vector-based API difficult. It lacks built-in support for important capabilities I frequently need (e.g., creating rectangles, finding perpendiculars).

At the same time, I find dealing with Windows' display coordinate system confusing, because of the oddball coordinate system it uses, with (0,0) being the upper-left corner of the screen and increasing values of the Y coordinate taking you down the screen, rather than up. Any API manipulating a (real) world coordinate system, like Google Maps, thus creates a (mind-bending) conflict when integrating such an API into a Windows/Microsoft program.

The vector-based and coordinate system utilties in this library attempt to address these issues.

VectorPolygon creates polygons from arrays of Vector2 objects via its static Create() method. It also lets you create rectangles from upper-left corner (X,Y) coordinates, a width and a height via its static CreateRectangle() method. VectorPolygon has no public constructor.

VectorPolygon provides a number of useful properties and methods:

Name Type Description
Vertices property read-only collection of Vector2 objects defining the polygon's vertices
Center property a Vector2 object defining the center of the polygon
IsConvex property true if the polygon is convex, false if it is concave
Edges enumerator an enumerator (IEnumerable<Vector2> of the polygon's edges
Minimum property a tuple (X,Y) of the upper-left corner of the polygon's bounding box
Maximum property a tuple (X,Y) of the lower-right corner of the polygon's bounding box
BoundingRectangle property a tuple (Width, Height) of the polygon's bounding box

The VectorExtensions static class contains a number of methods (some are extension methods) that I've found useful:

Name Type Description
Perpendicular extension method (Vector2) calculates the perpendicular to a Vector2, optionally normalizing it
Translate extension method (VectorPolygon) moves/translates a VectorPolygon along a provided Vector2 or X/Y deltas
Rotate extension method (VectorPolygon) rotates a VectorPolygon by a number of degrees, around an optional center point
GetPerpendiculars static enumerator enumerates Vector2 perpendiculars based on a collection of one or more VectorPolygons
GetNormalizedPerpendiculars static enumerator similar to GetPerpendiculars, but normalizes the calculated perpendiculars
Intersects static method returns true if two supplied VectorPolygons intersect, false otherwise, optionally throwing an exception if the supplied polygons are not each convex
Inside static method returns true if one of the two supplied VectorPolygons is inside the other, false otherwise, optionally throwing an exception if the supplied polygons are not each convex
ChangeCoordinateSystem converts a VectorPolygon from one coordinate system to another
Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net7.0

    • No dependencies.

NuGet packages (6)

Showing the top 5 NuGet packages that depend on J4JSoftware.VisualUtilities:

Package Downloads
J4JSoftware.GeoProcessor

a library for processing GPX, KML and KMZ files, and snapping GPS tracks to roadways
J4JSoftware.J4JMapWinLibrary

WinApp extensions to J4JMapLibrary
J4JSoftware.J4JMapLibrary

library for interfacing with map image servers
J4JSoftware.GeoProcessorApp

a console application for processing GPX, KML and KMZ files, and snapping GPS tracks to roadways
J4JSoftware.GeoProcessorWPF

a WPF application for processing GPX, KML and KMZ files, and snapping GPS tracks to roadways

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.1 445 4/11/2023
2.1.0 243 4/5/2023
2.0.0 297 12/29/2022
1.3.0 311 12/27/2022
1.1.0 374 11/12/2021
1.0.0 1,543 9/28/2021
0.8.1 1,030 2/3/2021
0.8.0 1,303 1/9/2021

updated to net7, added Vector2-based utilities