Sources/Classes/Application/Model/OpenGL/View/Snapshot/OpenGLViewPixels.m
/* |
File: OpenGLViewPixels.m |
Abstract: |
Utility function for copying pixels from an OpenGL view. |
Version: 1.2 |
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple |
Inc. ("Apple") in consideration of your agreement to the following |
terms, and your use, installation, modification or redistribution of |
this Apple software constitutes acceptance of these terms. If you do |
not agree with these terms, please do not use, install, modify or |
redistribute this Apple software. |
In consideration of your agreement to abide by the following terms, and |
subject to these terms, Apple grants you a personal, non-exclusive |
license, under Apple's copyrights in this original Apple software (the |
"Apple Software"), to use, reproduce, modify and redistribute the Apple |
Software, with or without modifications, in source and/or binary forms; |
provided that if you redistribute the Apple Software in its entirety and |
without modifications, you must retain this notice and the following |
text and disclaimers in all such redistributions of the Apple Software. |
Neither the name, trademarks, service marks or logos of Apple Inc. may |
be used to endorse or promote products derived from the Apple Software |
without specific prior written permission from Apple. Except as |
expressly stated in this notice, no other rights or licenses, express or |
implied, are granted by Apple herein, including but not limited to any |
patent rights that may be infringed by your derivative works or by other |
works in which the Apple Software may be incorporated. |
The Apple Software is provided by Apple on an "AS IS" basis. APPLE |
MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION |
THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS |
FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND |
OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS. |
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL |
OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, |
MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED |
AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE), |
STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE |
POSSIBILITY OF SUCH DAMAGE. |
Copyright (C) 2013 Apple Inc. All Rights Reserved. |
*/ |
//------------------------------------------------------------------------ |
//------------------------------------------------------------------------ |
#import "OpenGLViewPixels.h" |
//------------------------------------------------------------------------ |
//------------------------------------------------------------------------ |
@implementation OpenGLViewPixels |
//------------------------------------------------------------------------ |
//------------------------------------------------------------------------ |
- (id) initViewPixelsWithFrame:(const NSRect *)theFrame |
view:(NSOpenGLView *)theBaseView |
{ |
NSRect subFrameUpdated; |
if( theFrame == NULL ) |
{ |
subFrameUpdated = [theBaseView bounds]; |
} // if |
else |
{ |
subFrameUpdated = *theFrame; |
if( NSIsEmptyRect( subFrameUpdated ) ) |
{ |
subFrameUpdated = [theBaseView bounds]; |
} // if |
} // else |
self = [super initPBOPackWithSize:&subFrameUpdated.size |
usage:GL_STREAM_READ |
mode:GL_BACK]; |
if( self ) |
{ |
mpView = theBaseView; |
m_Frame = subFrameUpdated; |
} // if |
return( self ); |
} // initViewPixelsWithFrame |
//------------------------------------------------------------------------ |
- (void) dealloc |
{ |
// Dealloc the superclass |
[super dealloc]; |
} // dealloc |
//--------------------------------------------------------------------------- |
+ (id) viewPixelsWithFrame:(const NSRect *)theFrame |
view:(NSOpenGLView *)theBaseView |
{ |
return( [[[OpenGLViewPixels allocWithZone:[self zone]] initViewPixelsWithFrame:theFrame |
view:theBaseView] autorelease] ); |
} // viewPixelsWithFrame |
//------------------------------------------------------------------------ |
- (void) setFrame:(const NSRect *)theFrame |
{ |
if( theFrame == NULL ) |
{ |
m_Frame = [mpView bounds]; |
} // if |
else |
{ |
m_Frame = *theFrame; |
if( NSIsEmptyRect( m_Frame ) ) |
{ |
m_Frame = [mpView bounds]; |
} // if |
} // else |
[self setSize:&m_Frame.size]; |
} // pixelsSetFrame |
//------------------------------------------------------------------------ |
- (GLvoid *) pixels |
{ |
[self read:YES]; |
return( [self data] ); |
} // pixels |
//--------------------------------------------------------------------------- |
#pragma mark - |
#pragma mark Accessor |
//------------------------------------------------------------------------ |
- (NSRect) frame |
{ |
return( m_Frame ); |
} // frame |
//--------------------------------------------------------------------------- |
- (GLuint) rowbytes |
{ |
return( [self rowbytes] ); |
} // size |
//------------------------------------------------------------------------ |
@end |
//------------------------------------------------------------------------ |
//------------------------------------------------------------------------ |
Copyright © 2013 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2013-01-02