Ryujinx-GtkSharp/cairo/Context.cs
Mike Kestner ee866216b1 Cairo API 1.10 updates.
* cairo/*: merge changes to Mono.Cairo since we split back in Oct 2008.
  Not much changed.  Scrubbed the doc index and updated NativeMethods
  to match.  Commented with DONTCARE the ones we will ignore.  Implemented
  a few of them, including an initial Device binding.  Still some work
  to do, and some discovery to be done to see what happened to Xcb, Glitz,
  and DirectFB surfaces and whether we need to remove those classes.
2011-02-17 23:00:12 -06:00

922 lines
24 KiB
C#

//
// Mono.Cairo.Context.cs
//
// Author:
// Duncan Mak (duncan@ximian.com)
// Miguel de Icaza (miguel@novell.com)
// Hisham Mardam Bey (hisham.mardambey@gmail.com)
// Alp Toker (alp@atoker.com)
//
// (C) Ximian Inc, 2003.
// (C) Novell Inc, 2003.
//
// This is an OO wrapper API for the Cairo API.
//
// Copyright (C) 2004 Novell, Inc (http://www.novell.com)
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to
// permit persons to whom the Software is furnished to do so, subject to
// the following conditions:
//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
using System;
using System.Runtime.InteropServices;
using Cairo;
namespace Cairo {
public struct Point
{
public Point (int x, int y)
{
this.x = x;
this.y = y;
}
int x, y;
public int X {
get { return x; }
set { x = value; }
}
public int Y {
get { return y; }
set { y = value; }
}
}
public struct PointD
{
public PointD (double x, double y)
{
this.x = x;
this.y = y;
}
double x, y;
public double X {
get { return x; }
set { x = value; }
}
public double Y {
get { return y; }
set { y = value; }
}
}
public struct Distance
{
public Distance (double dx, double dy)
{
this.dx = dx;
this.dy = dy;
}
double dx, dy;
public double Dx {
get { return dx; }
set { dx = value; }
}
public double Dy {
get { return dy; }
set { dy = value; }
}
}
public struct Color
{
public Color(double r, double g, double b) : this (r, g, b, 1.0)
{
}
public Color(double r, double g, double b, double a)
{
this.r = r;
this.g = g;
this.b = b;
this.a = a;
}
double r, g, b, a;
public double R {
get { return r; }
set { r = value; }
}
public double G {
get { return g; }
set { g = value; }
}
public double B {
get { return b; }
set { b = value; }
}
public double A {
get { return a; }
set { a = value; }
}
}
[Obsolete ("Renamed Cairo.Context per suggestion from cairo binding guidelines.")]
public class Graphics : Context {
public Graphics (IntPtr state) : base (state) {}
public Graphics (Surface surface) : base (surface) {}
}
public class Context : IDisposable
{
internal IntPtr state = IntPtr.Zero;
static int native_glyph_size, c_compiler_long_size;
static Context ()
{
//
// This is used to determine what kind of structure
// we should use to marshal Glyphs, as the public
// definition in Cairo uses `long', which can be
// 32 bits or 64 bits depending on the platform.
//
// We assume that sizeof(long) == sizeof(void*)
// except in the case of Win64 where sizeof(long)
// is 32 bits
//
int ptr_size = Marshal.SizeOf (typeof (IntPtr));
PlatformID platform = Environment.OSVersion.Platform;
if (platform == PlatformID.Win32NT ||
platform == PlatformID.Win32S ||
platform == PlatformID.Win32Windows ||
platform == PlatformID.WinCE ||
ptr_size == 4){
c_compiler_long_size = 4;
native_glyph_size = Marshal.SizeOf (typeof (NativeGlyph_4byte_longs));
} else {
c_compiler_long_size = 8;
native_glyph_size = Marshal.SizeOf (typeof (Glyph));
}
}
public Context (Surface surface)
{
state = NativeMethods.cairo_create (surface.Handle);
}
public Context (IntPtr state)
{
this.state = NativeMethods.cairo_reference (state);
}
~Context ()
{
Dispose (false);
}
void IDisposable.Dispose ()
{
Dispose (true);
GC.SuppressFinalize (this);
}
protected virtual void Dispose (bool disposing)
{
if (!disposing){
Console.Error.WriteLine ("Cairo.Context: called from finalization thread, programmer is missing a call to Dispose");
return;
}
if (state == IntPtr.Zero)
return;
//Console.WriteLine ("Destroying");
NativeMethods.cairo_destroy (state);
state = IntPtr.Zero;
}
public void Save ()
{
NativeMethods.cairo_save (state);
}
public void Restore ()
{
NativeMethods.cairo_restore (state);
}
public Antialias Antialias {
get { return NativeMethods.cairo_get_antialias (state); }
set { NativeMethods.cairo_set_antialias (state, value); }
}
public Cairo.Status Status {
get {
return NativeMethods.cairo_status (state);
}
}
public IntPtr Handle {
get {
return state;
}
}
public Cairo.Operator Operator {
set {
NativeMethods.cairo_set_operator (state, value);
}
get {
return NativeMethods.cairo_get_operator (state);
}
}
//FIXME: obsolete this property
public Cairo.Color Color {
set {
NativeMethods.cairo_set_source_rgba (state, value.R, value.G, value.B, value.A);
}
}
[Obsolete ("Use Color property")]
public Cairo.Color ColorRgb {
set {
Color = new Color (value.R, value.G, value.B);
}
}
public double Tolerance {
get {
return NativeMethods.cairo_get_tolerance (state);
}
set {
NativeMethods.cairo_set_tolerance (state, value);
}
}
public Cairo.FillRule FillRule {
set {
NativeMethods.cairo_set_fill_rule (state, value);
}
get {
return NativeMethods.cairo_get_fill_rule (state);
}
}
public double LineWidth {
set {
NativeMethods.cairo_set_line_width (state, value);
}
get {
return NativeMethods.cairo_get_line_width (state);
}
}
public Cairo.LineCap LineCap {
set {
NativeMethods.cairo_set_line_cap (state, value);
}
get {
return NativeMethods.cairo_get_line_cap (state);
}
}
public Cairo.LineJoin LineJoin {
set {
NativeMethods.cairo_set_line_join (state, value);
}
get {
return NativeMethods.cairo_get_line_join (state);
}
}
public void SetDash (double [] dashes, double offset)
{
NativeMethods.cairo_set_dash (state, dashes, dashes.Length, offset);
}
public Pattern Pattern {
set {
NativeMethods.cairo_set_source (state, value.Pointer);
}
get {
return new Pattern (NativeMethods.cairo_get_source (state));
}
}
public Pattern Source {
set {
NativeMethods.cairo_set_source (state, value.Pointer);
}
get {
return Pattern.Lookup (NativeMethods.cairo_get_source (state));
}
}
public double MiterLimit {
set {
NativeMethods.cairo_set_miter_limit (state, value);
}
get {
return NativeMethods.cairo_get_miter_limit (state);
}
}
public PointD CurrentPoint {
get {
double x, y;
NativeMethods.cairo_get_current_point (state, out x, out y);
return new PointD (x, y);
}
}
public bool HasCurrentPoint {
get { return NativeMethods.cairo_has_current_point (state); }
}
public Cairo.Surface Target {
set {
if (state != IntPtr.Zero)
NativeMethods.cairo_destroy (state);
state = NativeMethods.cairo_create (value.Handle);
}
get {
return Cairo.Surface.LookupExternalSurface (
NativeMethods.cairo_get_target (state));
}
}
public Cairo.ScaledFont ScaledFont {
set {
NativeMethods.cairo_set_scaled_font (state, value.Handle);
}
get {
return new ScaledFont (NativeMethods.cairo_get_scaled_font (state));
}
}
public uint ReferenceCount {
get { return NativeMethods.cairo_get_reference_count (state); }
}
public void SetSourceRGB (double r, double g, double b)
{
NativeMethods.cairo_set_source_rgb (state, r, g, b);
}
public void SetSourceRGBA (double r, double g, double b, double a)
{
NativeMethods.cairo_set_source_rgba (state, r, g, b, a);
}
//[Obsolete ("Use SetSource method (with double parameters)")]
public void SetSourceSurface (Surface source, int x, int y)
{
NativeMethods.cairo_set_source_surface (state, source.Handle, x, y);
}
public void SetSource (Surface source, double x, double y)
{
NativeMethods.cairo_set_source_surface (state, source.Handle, x, y);
}
public void SetSource (Surface source)
{
NativeMethods.cairo_set_source_surface (state, source.Handle, 0, 0);
}
#region Path methods
public void NewPath ()
{
NativeMethods.cairo_new_path (state);
}
public void NewSubPath ()
{
NativeMethods.cairo_new_sub_path (state);
}
public void MoveTo (PointD p)
{
MoveTo (p.X, p.Y);
}
public void MoveTo (double x, double y)
{
NativeMethods.cairo_move_to (state, x, y);
}
public void LineTo (PointD p)
{
LineTo (p.X, p.Y);
}
public void LineTo (double x, double y)
{
NativeMethods.cairo_line_to (state, x, y);
}
public void CurveTo (PointD p1, PointD p2, PointD p3)
{
CurveTo (p1.X, p1.Y, p2.X, p2.Y, p3.X, p3.Y);
}
public void CurveTo (double x1, double y1, double x2, double y2, double x3, double y3)
{
NativeMethods.cairo_curve_to (state, x1, y1, x2, y2, x3, y3);
}
public void RelMoveTo (Distance d)
{
RelMoveTo (d.Dx, d.Dy);
}
public void RelMoveTo (double dx, double dy)
{
NativeMethods.cairo_rel_move_to (state, dx, dy);
}
public void RelLineTo (Distance d)
{
RelLineTo (d.Dx, d.Dy);
}
public void RelLineTo (double dx, double dy)
{
NativeMethods.cairo_rel_line_to (state, dx, dy);
}
public void RelCurveTo (Distance d1, Distance d2, Distance d3)
{
RelCurveTo (d1.Dx, d1.Dy, d2.Dx, d2.Dy, d3.Dx, d3.Dy);
}
public void RelCurveTo (double dx1, double dy1, double dx2, double dy2, double dx3, double dy3)
{
NativeMethods.cairo_rel_curve_to (state, dx1, dy1, dx2, dy2, dx3, dy3);
}
public void Arc (double xc, double yc, double radius, double angle1, double angle2)
{
NativeMethods.cairo_arc (state, xc, yc, radius, angle1, angle2);
}
public void ArcNegative (double xc, double yc, double radius, double angle1, double angle2)
{
NativeMethods.cairo_arc_negative (state, xc, yc, radius, angle1, angle2);
}
public void Rectangle (Rectangle rectangle)
{
Rectangle (rectangle.X, rectangle.Y, rectangle.Width, rectangle.Height);
}
public void Rectangle (PointD p, double width, double height)
{
Rectangle (p.X, p.Y, width, height);
}
public void Rectangle (double x, double y, double width, double height)
{
NativeMethods.cairo_rectangle (state, x, y, width, height);
}
public void ClosePath ()
{
NativeMethods.cairo_close_path (state);
}
public Path CopyPath ()
{
return new Path (NativeMethods.cairo_copy_path (state));
}
public Path CopyPathFlat ()
{
return new Path (NativeMethods.cairo_copy_path_flat (state));
}
public void AppendPath (Path path)
{
NativeMethods.cairo_append_path (state, path.handle);
}
public void PathExtents (out double x1, out double y1, out double x2, out double y2)
{
NativeMethods.cairo_path_extents (state, out x1, out y1, out x2, out y2);
}
#endregion
#region Painting Methods
public void Paint ()
{
NativeMethods.cairo_paint (state);
}
public void PaintWithAlpha (double alpha)
{
NativeMethods.cairo_paint_with_alpha (state, alpha);
}
public void Mask (Pattern pattern)
{
NativeMethods.cairo_mask (state, pattern.Pointer);
}
public void MaskSurface (Surface surface, double surface_x, double surface_y)
{
NativeMethods.cairo_mask_surface (state, surface.Handle, surface_x, surface_y);
}
public void Stroke ()
{
NativeMethods.cairo_stroke (state);
}
public void StrokePreserve ()
{
NativeMethods.cairo_stroke_preserve (state);
}
public Rectangle StrokeExtents ()
{
double x1, y1, x2, y2;
NativeMethods.cairo_stroke_extents (state, out x1, out y1, out x2, out y2);
return new Rectangle (x1, y1, x2, y2);
}
public void Fill ()
{
NativeMethods.cairo_fill (state);
}
public Rectangle FillExtents ()
{
double x1, y1, x2, y2;
NativeMethods.cairo_fill_extents (state, out x1, out y1, out x2, out y2);
return new Rectangle (x1, y1, x2, y2);
}
public void FillPreserve ()
{
NativeMethods.cairo_fill_preserve (state);
}
#endregion
public void Clip ()
{
NativeMethods.cairo_clip (state);
}
public void ClipPreserve ()
{
NativeMethods.cairo_clip_preserve (state);
}
public void ResetClip ()
{
NativeMethods.cairo_reset_clip (state);
}
public bool InStroke (double x, double y)
{
return NativeMethods.cairo_in_stroke (state, x, y);
}
public bool InClip (double x, double y)
{
return NativeMethods.cairo_in_clip (state, x, y);
}
public bool InFill (double x, double y)
{
return NativeMethods.cairo_in_fill (state, x, y);
}
public Pattern PopGroup ()
{
return Pattern.Lookup (NativeMethods.cairo_pop_group (state));
}
public void PopGroupToSource ()
{
NativeMethods.cairo_pop_group_to_source (state);
}
public void PushGroup ()
{
NativeMethods.cairo_push_group (state);
}
public void PushGroup (Content content)
{
NativeMethods.cairo_push_group_with_content (state, content);
}
public Surface GroupTarget {
get {
IntPtr surface = NativeMethods.cairo_get_group_target (state);
return Surface.LookupSurface (surface);
}
}
public void Rotate (double angle)
{
NativeMethods.cairo_rotate (state, angle);
}
public void Scale (double sx, double sy)
{
NativeMethods.cairo_scale (state, sx, sy);
}
public void Translate (double tx, double ty)
{
NativeMethods.cairo_translate (state, tx, ty);
}
public void Transform (Matrix m)
{
NativeMethods.cairo_transform (state, m);
}
#region Methods that will become obsolete in the long term, after 1.2.5 becomes wildly available
//[Obsolete("Use UserToDevice instead")]
public void TransformPoint (ref double x, ref double y)
{
NativeMethods.cairo_user_to_device (state, ref x, ref y);
}
//[Obsolete("Use UserToDeviceDistance instead")]
public void TransformDistance (ref double dx, ref double dy)
{
NativeMethods.cairo_user_to_device_distance (state, ref dx, ref dy);
}
//[Obsolete("Use InverseTransformPoint instead")]
public void InverseTransformPoint (ref double x, ref double y)
{
NativeMethods.cairo_device_to_user (state, ref x, ref y);
}
//[Obsolete("Use DeviceToUserDistance instead")]
public void InverseTransformDistance (ref double dx, ref double dy)
{
NativeMethods.cairo_device_to_user_distance (state, ref dx, ref dy);
}
#endregion
public void UserToDevice (ref double x, ref double y)
{
NativeMethods.cairo_user_to_device (state, ref x, ref y);
}
public void UserToDeviceDistance (ref double dx, ref double dy)
{
NativeMethods.cairo_user_to_device_distance (state, ref dx, ref dy);
}
public void DeviceToUser (ref double x, ref double y)
{
NativeMethods.cairo_device_to_user (state, ref x, ref y);
}
public void DeviceToUserDistance (ref double dx, ref double dy)
{
NativeMethods.cairo_device_to_user_distance (state, ref dx, ref dy);
}
public Cairo.Matrix Matrix {
set {
NativeMethods.cairo_set_matrix (state, value);
}
get {
Matrix m = new Matrix();
NativeMethods.cairo_get_matrix (state, m);
return m;
}
}
public void SetFontSize (double scale)
{
NativeMethods.cairo_set_font_size (state, scale);
}
public void IdentityMatrix ()
{
NativeMethods.cairo_identity_matrix (state);
}
[Obsolete ("Use SetFontSize() instead.")]
public void FontSetSize (double scale)
{
SetFontSize (scale);
}
[Obsolete ("Use SetFontSize() instead.")]
public double FontSize {
set { SetFontSize (value); }
}
public Matrix FontMatrix {
get {
Matrix m;
NativeMethods.cairo_get_font_matrix (state, out m);
return m;
}
set { NativeMethods.cairo_set_font_matrix (state, value); }
}
public FontOptions FontOptions {
get {
FontOptions options = new FontOptions ();
NativeMethods.cairo_get_font_options (state, options.Handle);
return options;
}
set { NativeMethods.cairo_set_font_options (state, value.Handle); }
}
[StructLayout(LayoutKind.Sequential)]
internal struct NativeGlyph_4byte_longs {
public int index;
public double x;
public double y;
public NativeGlyph_4byte_longs (Glyph source)
{
index = (int) source.index;
x = source.x;
y = source.y;
}
}
static internal IntPtr FromGlyphToUnManagedMemory(Glyph [] glyphs)
{
IntPtr dest = Marshal.AllocHGlobal (native_glyph_size * glyphs.Length);
long pos = dest.ToInt64();
if (c_compiler_long_size == 8){
foreach (Glyph g in glyphs){
Marshal.StructureToPtr (g, (IntPtr)pos, false);
pos += native_glyph_size;
}
} else {
foreach (Glyph g in glyphs){
NativeGlyph_4byte_longs n = new NativeGlyph_4byte_longs (g);
Marshal.StructureToPtr (n, (IntPtr)pos, false);
pos += native_glyph_size;
}
}
return dest;
}
public void ShowGlyphs (Glyph[] glyphs)
{
IntPtr ptr;
ptr = FromGlyphToUnManagedMemory (glyphs);
NativeMethods.cairo_show_glyphs (state, ptr, glyphs.Length);
Marshal.FreeHGlobal (ptr);
}
[Obsolete("The matrix argument was never used, use ShowGlyphs(Glyphs []) instead")]
public void ShowGlyphs (Matrix matrix, Glyph[] glyphs)
{
ShowGlyphs (glyphs);
}
[Obsolete("The matrix argument was never used, use GlyphPath(Glyphs []) instead")]
public void GlyphPath (Matrix matrix, Glyph[] glyphs)
{
GlyphPath (glyphs);
}
public void GlyphPath (Glyph[] glyphs)
{
IntPtr ptr;
ptr = FromGlyphToUnManagedMemory (glyphs);
NativeMethods.cairo_glyph_path (state, ptr, glyphs.Length);
Marshal.FreeHGlobal (ptr);
}
public FontExtents FontExtents {
get {
FontExtents f_extents;
NativeMethods.cairo_font_extents (state, out f_extents);
return f_extents;
}
}
public void CopyPage ()
{
NativeMethods.cairo_copy_page (state);
}
[Obsolete ("Use SelectFontFace() instead.")]
public void FontFace (string family, FontSlant slant, FontWeight weight)
{
SelectFontFace (family, slant, weight);
}
public FontFace ContextFontFace {
get {
return Cairo.FontFace.Lookup (NativeMethods.cairo_get_font_face (state));
}
set {
NativeMethods.cairo_set_font_face (state, value == null ? IntPtr.Zero : value.Handle);
}
}
public void SelectFontFace (string family, FontSlant slant, FontWeight weight)
{
NativeMethods.cairo_select_font_face (state, family, slant, weight);
}
public void ShowPage ()
{
NativeMethods.cairo_show_page (state);
}
public void ShowText (string str)
{
NativeMethods.cairo_show_text (state, str);
}
public void TextPath (string str)
{
NativeMethods.cairo_text_path (state, str);
}
public TextExtents TextExtents (string utf8)
{
TextExtents extents;
NativeMethods.cairo_text_extents (state, utf8, out extents);
return extents;
}
public TextExtents GlyphExtents (Glyph[] glyphs)
{
IntPtr ptr = FromGlyphToUnManagedMemory (glyphs);
TextExtents extents;
NativeMethods.cairo_glyph_extents (state, ptr, glyphs.Length, out extents);
Marshal.FreeHGlobal (ptr);
return extents;
}
public static int FormatStrideForWidth (Format format, int width)
{
return NativeMethods.cairo_format_stride_for_width (format, width);
}
}
}