aboutsummaryrefslogblamecommitdiffstats
path: root/src/lib/fake-quartz-cg.h
blob: a77ccc65f0767b38896ecb3437c16e63cfc2505b (plain) (tree)
1
2
3
   
                                                                          
                                                                      
















                                                                        

                                                                                    


      
               
                         


      














                                                                                                                                                               


                                                                   
                        



                           

                         


                                                                
                           



                                  


                                   









                                                                                               

                                                                                                       
 









                                                                                  


                                                                                                            










                                                                                               


                                                                                                    
 


                                                                   

                                             





                                                            







                                                                                       



                                         


                                

               
                     

      

      
/**
 * libgamma -- Display server abstraction layer for gamma ramp adjustments
 * Copyright (C) 2014, 2015  Mattias Andrée (maandree@member.fsf.org)
 * 
 * This library is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 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 General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this library.  If not, see <http://www.gnu.org/licenses/>.
 */
#ifndef LIBGAMMA_FAKE_QUARTZ_CG_H
#define LIBGAMMA_FAKE_QUARTZ_CG_H

#ifndef FAKE_LIBGAMMA_METHOD_QUARTZ_CORE_GRAPHICS
# error Including fake-quartz-cg.h without FAKE_LIBGAMMA_METHOD_QUARTZ_CORE_GRAPHICS
#endif


#ifndef __GCC__
# define __attribute__(x)
#endif


/* This header file contains some capabilities of
 * <CoreGraphics/CGDirectDisplay.h> and <CoreGraphics/CGError.h>,
 * and can be used modify gamma ramps without Mac OS X and Quartz
 * but with its API.
 * 
 * The content of this file is based on the documentation found on:
 * 
 * https://developer.apple.com/library/mac/documentation/GraphicsImaging/Reference/Quartz_Services_Ref/Reference/reference.html
 * 
 * https://developer.apple.com/library/mac/documentation/CoreGraphics/Reference/CoreGraphicsConstantsRef/Reference/reference.html#//apple_ref/c/tdef/CGError */


#include <stdint.h>


/**
 * Numerical `typedef` for errors that occur in CoreGraphics calls.
 */
typedef int32_t CGError;

/**
 * The call was successful.
 */
#define kCGErrorSuccess 0

/**
 * The data type that is used for the values in the gamma ramps.
 */
typedef float CGGammaValue;

/**
 * The data type for display ID:s.
 */
typedef uint32_t CGDirectDisplayID;


/**
 * Get a list of all online displays on the system.
 * 
 * @param   max_size      The number of elements allocated for `displays_out`.
 * @param   displays_out  List ot fill with the ID for each online display on the system.
 * @param   count_out     Output parameter for the number of elements stored in `displays_out`.
 *                        if `displays_out` is too small to fit all display ID:s,
 *                        `*count_out` will be `max_size`.
 * @return                `kCGErrorSuccess` on success, and error number of failure.
 */
CGError CGGetOnlineDisplayList(uint32_t max_size,
			       CGDirectDisplayID* restrict displays_out, uint32_t* restrict count_out);

/**
 * Set the gamma ramps for a display.
 * 
 * @param   display     The ID of the display.
 * @param   gamma_size  The number of stops in gamma ramps.
 * @param   red         The gamma ramp for the red channel.
 * @param   green       The gamma ramp for the green channel.
 * @param   blue        The gamma ramp for the blue channel.
 * @return              `kCGErrorSuccess` on success, and error number of failure.
 */
CGError CGSetDisplayTransferByTable(CGDirectDisplayID display, uint32_t gamma_size, const CGGammaValue* red,
				    const CGGammaValue* green, const CGGammaValue* blue);

/**
 * Get the current gamma ramps for a display.
 * 
 * @param   display         The ID of the display.
 * @param   gamma_size      The number of stops you have allocated for the gamma ramps.
 * @param   red             Table allocated for the gamma ramp for the red channel.
 * @param   green           Table allocated for the gamma ramp for the green channel.
 * @param   blue            Table allocated for the gamma ramp for the blue channel.
 * @param   gamma_size_out  Output parameter for the actual number of stops in the gamma ramps.
 * @return                  `kCGErrorSuccess` on success, and error number of failure.
 */
CGError CGGetDisplayTransferByTable(CGDirectDisplayID display, uint32_t gamma_size,
				    CGGammaValue* restrict red, CGGammaValue* restrict green,
				    CGGammaValue* restrict blue, uint32_t* restrict gamma_size_out);

/**
 * Restore each display's gamma ramps to the settings in ColorSync.
 */
void CGDisplayRestoreColorSyncSettings(void);

/**
 * Get the number of stops in the gamma ramps for a display.
 * 
 * @param   display  The ID of the display.
 * @return           The number of stops in the gamma ramps.
 */
uint32_t CGDisplayGammaTableCapacity(CGDirectDisplayID display) __attribute__((const));


/* The follow part most only be used when this module is used,
 * it cannot be used when the real CoreGraphics is used.
 * CoreGraphics does not have this function, it is added so
 * that there is a way to cleanly close the X connection
 * and free resources needed by this module. */

/**
 * Release resources used by the backend.
 */
void close_fake_quartz_cg(void);



#ifndef __GCC__
# undef __attribute__
#endif

#endif