libmks/lib/mks-screen-attributes.c

191 lines
4.7 KiB
C
Raw Permalink Normal View History

/*
* mks-screen-attributes.c
*
* Copyright 2023 Christian Hergert <chergert@redhat.com>
*
* This library is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of the
* License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
2023-06-01 11:04:35 +00:00
* SPDX-License-Identifier: LGPL-2.1-or-later
*/
#include "config.h"
#include "mks-screen-attributes-private.h"
2023-05-23 10:24:33 +00:00
/**
* MksScreenAttributes:
*
* Screen attributes.
*
* The attributes are used to reconfigure the QEMU instance with
* [method@Mks.Screen.configure] or [method@Mks.Screen.configure_sync].
*/
G_DEFINE_BOXED_TYPE (MksScreenAttributes,
mks_screen_attributes,
mks_screen_attributes_copy,
mks_screen_attributes_free)
/**
* mks_screen_attributes_new:
*
* Creates a new #MksScreenAttributes.
*
* Returns: (transfer full): A newly created #MksScreenAttributes
*/
MksScreenAttributes *
mks_screen_attributes_new (void)
{
return g_new0 (MksScreenAttributes, 1);
}
/**
* mks_screen_attributes_copy:
* @self: (nullable): a #MksScreenAttributes
*
* Makes a deep copy of a #MksScreenAttributes.
*
* Returns: (transfer full): A newly created #MksScreenAttributes with the same
* contents as @self. If @self is %NULL, %NULL is returned.
*/
MksScreenAttributes *
mks_screen_attributes_copy (MksScreenAttributes *self)
{
if (self == NULL)
return NULL;
return g_memdup2 (self, sizeof *self);
}
/**
* mks_screen_attributes_free:
* @self: a #MksScreenAttributes
*
2023-05-23 10:24:33 +00:00
* Frees a #MksScreenAttributes.
*
* Allocated using [ctor@Mks.ScreenAttributes.new]
* or [method@Mks.ScreenAttributes.copy].
*/
void
mks_screen_attributes_free (MksScreenAttributes *self)
{
g_free (self);
}
/**
* mks_screen_attributes_equal:
* @self: a #MksScreenAttributes
* @other: a #MksScreenAttributes
*
* Returns `true` if the two attributes are equal, `false` otherwise.
*/
gboolean
mks_screen_attributes_equal (MksScreenAttributes *self,
MksScreenAttributes *other)
{
if (self == NULL || other == NULL)
return FALSE;
return (self->width == other->width &&
self->height == other->height &&
self->x_offset == other->x_offset &&
self->y_offset == other->y_offset &&
self->width_mm == other->width_mm &&
self->height_mm == other->height_mm);
}
2023-05-23 10:24:33 +00:00
/**
* mks_screen_attributes_set_width_mm:
* @self: A MksScreenAttributes.
* @width_mm: The screen width.
*
* Set the screen width in millimeters.
*/
void
mks_screen_attributes_set_width_mm (MksScreenAttributes *self,
guint16 width_mm)
{
self->width_mm = width_mm;
}
2023-05-23 10:24:33 +00:00
/**
* mks_screen_attributes_set_height_mm:
* @self: A MksScreenAttributes.
* @height_mm: The screen height.
*
* Set the screen height in millimeters.
*/
void
mks_screen_attributes_set_height_mm (MksScreenAttributes *self,
guint16 height_mm)
{
self->height_mm = height_mm;
}
2023-05-23 10:24:33 +00:00
/**
* mks_screen_attributes_set_x_offset:
* @self: A MksScreenAttributes.
* @x_offset: The screen's horizontal offset.
*
* Set the screen's horizontal offset in pixels.
*/
void
mks_screen_attributes_set_x_offset (MksScreenAttributes *self,
int x_offset)
{
self->x_offset = x_offset;
}
2023-05-23 10:24:33 +00:00
/**
* mks_screen_attributes_set_y_offset:
* @self: A MksScreenAttributes.
* @y_offset: The screen's vertical offset.
*
* Set the screen's vertical offset in pixels.
*/
void
mks_screen_attributes_set_y_offset (MksScreenAttributes *self,
int y_offset)
{
self->y_offset = y_offset;
}
2023-05-23 10:24:33 +00:00
/**
* mks_screen_attributes_set_width:
* @self: A MksScreenAttributes.
* @width: The screen width.
*
* Set the screen width in pixels.
*/
void
mks_screen_attributes_set_width (MksScreenAttributes *self,
guint width)
{
self->width = width;
}
2023-05-23 10:24:33 +00:00
/**
* mks_screen_attributes_set_height:
* @self: A MksScreenAttributes.
* @height: The screen height.
*
* Set the screen height in pixels.
*/
void
mks_screen_attributes_set_height (MksScreenAttributes *self,
guint height)
{
self->height = height;
}