FreeRDP/client/iOS/Models/RDPSession.h
2013-12-04 12:30:33 +01:00

109 lines
3.0 KiB
Objective-C

/*
RDP Session object
Copyright 2013 Thincast Technologies GmbH, Authors: Martin Fleisz, Dorian Johnson
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
#include <freerdp/freerdp.h>
// forward declaration
@class RDPSession;
@class ComputerBookmark;
@class ConnectionParams;
// notification handler for session disconnect
extern NSString* TSXSessionDidDisconnectNotification;
extern NSString* TSXSessionDidFailToConnectNotification;
// protocol for session notifications
@protocol RDPSessionDelegate <NSObject>
@optional
- (void)session:(RDPSession*)session didFailToConnect:(int)reason;
- (void)sessionWillConnect:(RDPSession*)session;
- (void)sessionDidConnect:(RDPSession*)session;
- (void)sessionWillDisconnect:(RDPSession*)session;
- (void)sessionDidDisconnect:(RDPSession*)session;
- (void)sessionBitmapContextWillChange:(RDPSession*)session;
- (void)sessionBitmapContextDidChange:(RDPSession*)session;
- (void)session:(RDPSession*)session needsRedrawInRect:(CGRect)rect;
- (CGSize)sizeForFitScreenForSession:(RDPSession*)session;
- (void)session:(RDPSession*)session requestsAuthenticationWithParams:(NSMutableDictionary*)params;
- (void)session:(RDPSession*)session verifyCertificateWithParams:(NSMutableDictionary*)params;
@end
// rdp session
@interface RDPSession : NSObject
{
@private
freerdp* _freerdp;
ComputerBookmark* _bookmark;
ConnectionParams* _params;
NSObject<RDPSessionDelegate>* _delegate;
NSCondition* _ui_request_completed;
NSString* _name;
// flag if the session is suspended
BOOL _suspended;
// flag that specifies whether the RDP toolbar is visible
BOOL _toolbar_visible;
}
@property (readonly) ConnectionParams* params;
@property (readonly) ComputerBookmark* bookmark;
@property (assign) id <RDPSessionDelegate> delegate;
@property (assign) BOOL toolbarVisible;
@property (readonly) CGContextRef bitmapContext;
@property (readonly) NSCondition* uiRequestCompleted;
// initialize a new session with the given bookmark
- (id)initWithBookmark:(ComputerBookmark*)bookmark;
#pragma mark - session control functions
// connect the session
-(void)connect;
// disconnect session
-(void)disconnect;
// suspends the session
-(void)suspend;
// resumes a previously suspended session
-(void)resume;
// returns YES if the session is started
-(BOOL)isSuspended;
// send input event to the server
-(void)sendInputEvent:(NSDictionary*)event;
// session needs a refresh of its view
- (void)setNeedsDisplayInRectAsValue:(NSValue*)rect_value;
// get a small session screenshot
- (UIImage*)getScreenshotWithSize:(CGSize)size;
// returns the session's current paramters
- (rdpSettings*)getSessionParams;
// returns the session's name (usually the label of the bookmark the session was created with)
- (NSString*)sessionName;
@end